How vinyluis/claude-code-supervisor works
Claude Code Supervisor is a Python wrapper that coordinates a coding agent and a supervisor LLM to solve programming tasks. Users submit a problem through the public agent API; optional plan review precedes coding, then the supervisor monitors results and either returns a completion or supplies feedback for another iteration. The README documents data I/O, custom prompts and tools, automated tests, and Anthropic, Bedrock, and OpenAI support. Internal details are based on sampled excerpts and the source index; unsampled implementation links are omitted where their ownership is unclear.
Main entry points: supervisor.py Workflow Engine · __init__.py Supervisor API · config.py Agent Configuration · __version__.py Package Metadata
Components 17
Public API
- Supervisor API
claude_code_supervisor/__init__.py - Package Metadata
claude_code_supervisor/__version__.py
Workflow Orchestration
- Workflow Engine
claude_code_supervisor/supervisor.py - Execution Session
claude_code_supervisor/supervisor.py - Progress Monitoring
claude_code_supervisor/supervisor.py - Test Analysis
claude_code_supervisor/supervisor.py - Feedback Loop
claude_code_supervisor/supervisor.py
Plan Review
- Plan Mode
claude_code_supervisor/supervisor.py - Plan Review
claude_code_supervisor/supervisor.py
Configuration and Support
- Agent Configuration
claude_code_supervisor/config.py - Prompt Templates
claude_code_supervisor/prompts.py - Output Utilities
claude_code_supervisor/utils.py
Agent Integrations
- Claude Code
- Guidance LLM
- Custom Tools
- Model Providers
Other components
- Developer
Connections 22
- Developer → Supervisor API: submits problem
README.md - Supervisor API → Workflow Engine: invokes agent
claude_code_supervisor/__init__.py - Workflow Engine → Agent Configuration: loads settings
claude_code_supervisor/supervisor.py - Workflow Engine → Prompt Templates: builds instructions
claude_code_supervisor/supervisor.py - Workflow Engine → Output Utilities: formats progress
claude_code_supervisor/supervisor.py - Workflow Engine → Plan Mode: starts optional plan
claude_code_supervisor/supervisor.py - Plan Mode → Claude Code: requests plan
README.md - Plan Mode → Plan Review: reviews plan
claude_code_supervisor/supervisor.py - Plan Review → Guidance LLM: scores plan
- Plan Review → Execution Session: approves plan
claude_code_supervisor/supervisor.py - Workflow Engine → Execution Session: runs execution
claude_code_supervisor/supervisor.py - Execution Session → Claude Code: runs coding session
README.md - Claude Code → Progress Monitoring: reports progress
README.md - Progress Monitoring → Test Analysis: provides results
claude_code_supervisor/supervisor.py - Test Analysis → Claude Code: runs tests
README.md - Test Analysis → Feedback Loop: reports issues
claude_code_supervisor/supervisor.py - Feedback Loop → Guidance LLM: requests guidance
README.md - Feedback Loop → Claude Code: sends feedback
README.md - Agent Configuration → Model Providers: selects provider
- Agent Configuration → Custom Tools: configures tools
- Workflow Engine → Model Providers: uses model
- Supervisor API → Package Metadata: exports version
claude_code_supervisor/__init__.py