Skip to content

Commit 514da5e

Browse files
authored
Merge pull request #81 from guyskk/feature/remove-supervisor
feat: remove supervisor mode
2 parents 60e671d + 2c54021 commit 514da5e

34 files changed

Lines changed: 237 additions & 7464 deletions

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
### Removed
11+
12+
- Supervisor mode (replaced by Claude Code's built-in goal and loop functionality)
13+
- Removed all supervisor-related code, tests, config, and dependencies
14+
- Removed supervisor-hook and supervisor-mode CLI commands
15+
- Removed slash command files (supervisor.md, supervisoroff.md)
16+
- Project rebranded as "Claude Code Configuration Switcher"
17+
1018
## [0.3.0] - 2026-01-16
1119

1220
### Added

README-CN.md

Lines changed: 4 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,10 @@
1-
# ccc - Claude Code 监督器
1+
# ccc - Claude Code 配置切换器
22

33
[English](README.md) | [中文文档](README-CN.md)
44

55
## 为什么选择 ccc?
66

7-
`ccc` 是一个增强 Claude Code 的命令行工具,提供两大核心功能:
8-
9-
1. **Supervisor 模式**: ⭐ 自动任务审查,确保高质量、可交付的成果
10-
2. **无缝提供商切换**: 一条命令在 Kimi、GLM、MiniMax 等提供商之间切换
11-
12-
**优于 `ralph-claude-code`**
13-
14-
- Supervisor 模式使用 Stop Hook 触发的审查机制配合严格的六步框架,显著提高任务完成度和质量。
15-
- 与 ralph 基于信号的退出检测不同,ccc 的 Supervisor 会 Fork 完整的会话上下文来评估实际工作质量。
16-
- 这有效防止了 AI 声称"完成"但结果质量差、仍有很多问题的虚假完成情况。
7+
`ccc` 是一个为 Claude Code 提供无缝提供商切换的命令行工具。一条命令在 Kimi、GLM、MiniMax 等提供商之间切换。
178

189
## 快速开始
1910

@@ -108,8 +99,7 @@ ccc validate --all
10899

109100
#### 管理的内容
110101

111-
- 🤖 Supervisor Stop hook - 自动添加/确保
112-
- ⚙️ Hook 执行标志 - `disableAllHooks``allowManagedHooksOnly` 设置为 `false` 以确保 hooks 能正常工作
102+
- 🧹 Supervisor Stop hook - 如果存在旧版本的 hook,会自动清理
113103

114104
#### 环境变量冲突(硬守卫)
115105

@@ -129,48 +119,10 @@ Claude Code 的 `settings.json` `env` 字段会**覆盖**ccc 启动 claude 时
129119
1. 读取现有的 `settings.json`(如果存在)
130120
2. 按优先级合并配置:`用户 > 提供商 > 基础`
131121
3. 提供商的环境变量通过命令行传递(不写入 `settings.json`
132-
4. 添加 Supervisor Stop hook(如果需要)同时保留用户的其他 hooks
122+
4. 清理遗留的 Supervisor hooks
133123

134124
这样可以确保你的手动配置永远不会丢失!
135125

136-
## Supervisor 模式(推荐)
137-
138-
Supervisor 模式是 `ccc` 最有价值的特性。它会在 Agent 每次停止后自动审查工作质量,如果未完成则提供反馈让 Agent 继续执行。
139-
140-
### 如何使用
141-
142-
1. 启动 `ccc`,与 Agent 沟通确认需求和方案:
143-
144-
```bash
145-
ccc
146-
```
147-
148-
2. 使用斜杠命令启用 Supervisor 模式:
149-
150-
```text
151-
/supervisor 好,开始执行
152-
```
153-
154-
3. Agent 会执行任务,Supervisor 会在每次停止后自动审查
155-
- 如果工作未完成,Supervisor 会提供反馈,Agent 继续执行
156-
- 重复直到 Supervisor 确认工作完成
157-
158-
### 工作原理
159-
160-
1. Agent 完成任务并停止,触发 Claude Code 的 Stop Hook
161-
2. Supervisor(一个 Claude 实例)执行严格的审查工作
162-
3. 如果工作未完成或质量不佳,Supervisor 提供反馈
163-
4. Agent 根据反馈继续工作
164-
5. 重复直到 Supervisor 确认工作完成
165-
166-
### Statusline显示
167-
168-
可以在Claude code里输入以下指令,帮你配置好Statusline显示。
169-
170-
```text
171-
/statusline 帮我配置statusline脚本,里面调用 `ccc supervisor-mode` 命令,这个命令会输出 on 或者 off,我希望显示成类似 ... | supervisor on 这样的效果。
172-
```
173-
174126
## Patch 命令:用 ccc 替代 `claude` 命令
175127

176128
通过替换系统中的 `claude` 命令,让任何调用 `claude` 的工具都使用配置了提供商的 `ccc` 命令。
@@ -200,10 +152,6 @@ sudo ccc patch --reset
200152
},
201153
"alwaysThinkingEnabled": true
202154
},
203-
"supervisor": {
204-
"max_iterations": 20,
205-
"timeout_seconds": 600
206-
},
207155
"claude_args": ["--verbose"],
208156
"current_provider": "glm",
209157
"providers": {
@@ -231,7 +179,6 @@ sudo ccc patch --reset
231179
| 字段 | 说明 |
232180
| ------------------ | ------------------------------------- |
233181
| `settings` | 所有提供商共享的 Claude Code 配置模板 |
234-
| `supervisor` | Supervisor 模式配置(可选) |
235182
| `claude_args` | 固定传递给 Claude Code 的参数(可选) |
236183
| `current_provider` | 当前使用的提供商(由 ccc 自动管理) |
237184
| `providers.{name}` | 提供商特定的 Claude Code 配置 |
@@ -249,17 +196,6 @@ sudo ccc patch --reset
249196

250197
**合并方式**:提供商设置与基础模板深度合并。提供商的 `env` 优先于 `settings.env`
251198

252-
### Supervisor 配置
253-
254-
| 字段 | 说明 | 默认值 |
255-
| ----------------- | -------------------------------- | ------- |
256-
| `max_iterations` | 当前会话强制停止前的最大迭代次数 | `20` |
257-
| `timeout_seconds` | 每次 supervisor 调用的超时时间 | `600` |
258-
259-
### 自定义 Supervisor 提示词
260-
261-
创建 `~/.claude/SUPERVISOR.md` 来自定义 Supervisor 提示词。此文件会使用你自己的指令覆盖默认的审查行为。
262-
263199
### 环境变量
264200

265201
| 变量 | 说明 |

README.md

Lines changed: 4 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,10 @@
1-
# ccc - Claude Code Supervisor
1+
# ccc - Claude Code Configuration Switcher
22

33
[English](README.md) | [中文文档](README-CN.md)
44

55
## Why ccc?
66

7-
`ccc` is a CLI tool that enhances Claude Code with two core features:
8-
9-
1. **Supervisor Mode**: ⭐ Automatic task review that ensures high-quality, deliverable work
10-
2. **Seamless Provider Switching**: Switch between Kimi, GLM, MiniMax, and other providers with one command
11-
12-
**Better than `ralph-claude-code`**:
13-
14-
- Supervisor Mode uses a Stop Hook triggered review with a strict framework that significantly improves task completion and quality.
15-
- Unlike ralph's signal-based exit detection, ccc's Supervisor forks the full session context to evaluate actual work quality.
16-
- This prevents fake completions where AI claims "done" but the result has poor quality or unresolved issues.
7+
`ccc` is a CLI tool that provides seamless provider switching for Claude Code. Switch between Kimi, GLM, MiniMax, and other providers with one command.
178

189
## Quick Start
1910

@@ -91,44 +82,6 @@ ccc validate
9182
ccc validate --all
9283
```
9384

94-
## Supervisor Mode (Recommended)
95-
96-
Supervisor Mode is the most valuable feature of `ccc`. It automatically reviews the Agent's work after each stop and provides feedback if incomplete.
97-
98-
### How to Use
99-
100-
1. Start `ccc`, chat with the Agent to confirm requirements and approach:
101-
102-
```bash
103-
ccc
104-
```
105-
106-
2. Enable Supervisor Mode using the slash command:
107-
108-
```text
109-
/supervisor OK, start executing
110-
```
111-
112-
3. The Agent will execute the task, and Supervisor will automatically review after each stop
113-
- If work is incomplete, Supervisor provides feedback and Agent continues
114-
- This repeats until Supervisor confirms the work is complete
115-
116-
### How It Works
117-
118-
1. Agent completes a task and stops, triggering Claude Code's Stop Hook
119-
2. Supervisor (a Claude instance) performs a strict review
120-
3. If work is incomplete or low quality, Supervisor provides feedback
121-
4. Agent continues with the feedback
122-
5. This repeats until Supervisor confirms the work is complete
123-
124-
### Statusline Display
125-
126-
You can configure the statusline in Claude Code to show Supervisor Mode status:
127-
128-
```text
129-
/statusline Help me configure a statusline script that calls `ccc supervisor-mode` command, which outputs "on" or "off". I want it to display like "... | supervisor on"
130-
```
131-
13285
## Patch Command: Replace `claude` with `ccc`
13386

13487
Make `ccc` your default Claude Code by replacing the system `claude` command.
@@ -165,8 +118,7 @@ Config file location, default: `~/.claude/ccc.json`
165118

166119
#### What Gets Managed
167120

168-
- 🤖 Supervisor Stop hook - automatically added/ensured
169-
- ⚙️ Hook execution flags - `disableAllHooks` and `allowManagedHooksOnly` set to `false` to ensure hooks work
121+
- 🧹 Supervisor Stop hook - automatically cleaned up if present from previous versions
170122

171123
#### Environment Variable Conflicts (Hard Guard)
172124

@@ -186,7 +138,7 @@ When you run `ccc`:
186138
1. Your existing `settings.json` is read (if it exists)
187139
2. Configuration is merged with priority: `user > provider > base`
188140
3. Environment variables from provider are passed via command line (not written to settings.json)
189-
4. Supervisor Stop hook is added (if needed) while preserving your other hooks
141+
4. Leftover Supervisor hooks are cleaned up
190142

191143
This ensures your manual configuration is never lost!
192144

@@ -198,10 +150,6 @@ This ensures your manual configuration is never lost!
198150
},
199151
"alwaysThinkingEnabled": true
200152
},
201-
"supervisor": {
202-
"max_iterations": 20,
203-
"timeout_seconds": 600
204-
},
205153
"claude_args": ["--verbose"],
206154
"current_provider": "glm",
207155
"providers": {
@@ -229,7 +177,6 @@ This ensures your manual configuration is never lost!
229177
| Field | Description |
230178
| ------------------- | -------------------------------------------- |
231179
| `settings` | Shared Claude Code config template for all providers |
232-
| `supervisor` | Supervisor mode configuration (optional) |
233180
| `claude_args` | Fixed arguments to pass to Claude Code (optional) |
234181
| `current_provider` | Currently used provider (auto-managed by ccc) |
235182
| `providers.{name}` | Provider-specific Claude Code configuration |
@@ -247,17 +194,6 @@ Each provider only needs to specify the fields it wants to override. Common fiel
247194

248195
**How merging works**: Provider settings are deep-merged with the base template. Provider `env` takes precedence over `settings.env`.
249196

250-
### Supervisor Configuration
251-
252-
| Field | Description | Default |
253-
| ----------------- | ---------------------------------------------- | ------- |
254-
| `max_iterations` | Maximum iterations before forcing stop | `20` |
255-
| `timeout_seconds` | Timeout per supervisor call in seconds | `600` |
256-
257-
### Custom Supervisor Prompt
258-
259-
Create `~/.claude/SUPERVISOR.md` to customize the Supervisor prompt. This file overrides the default review behavior with your own instructions.
260-
261197
### Environment Variables
262198

263199
| Variable | Description |

cmd/test-sdk-auto-compact/README.md

Lines changed: 0 additions & 142 deletions
This file was deleted.

0 commit comments

Comments
 (0)