guyskk/claude-code-supervisor

77 stars · Last commit 2026-03-26

Auto-review and iterate until quality work is delivered - a better alternative to ralph-claude-code. Switch between multiple Claude Code providers (Kimi, GLM, MiniMax, etc.) with a single command.

README preview

# ccc - Claude Code Supervisor

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

## Why ccc?

`ccc` is a CLI tool that enhances Claude Code with two core features:

1. **Supervisor Mode**: ⭐ Automatic task review that ensures high-quality, deliverable work
2. **Seamless Provider Switching**: Switch between Kimi, GLM, MiniMax, and other providers with one command

**Better than `ralph-claude-code`**:

- Supervisor Mode uses a Stop Hook triggered review with a strict framework that significantly improves task completion and quality.
- Unlike ralph's signal-based exit detection, ccc's Supervisor forks the full session context to evaluate actual work quality.
- This prevents fake completions where AI claims "done" but the result has poor quality or unresolved issues.

## Quick Start

### 1. Install

View full repository on GitHub →