ClaudeCast

A Claude Code plugin that turns Claude into a prompt compiler — Claude maps your codebase, generates targeted model-agnostic prompts, and reviews the output. You paste the prompts into cheaper models (Gemini, GPT, etc.) for bulk code generation. Claude handles the thinking; commodity models handle the typing.

Why

Claude is great at understanding codebases but expensive for writing boilerplate. ClaudeCast exploits this gap: Claude spends tokens on high-leverage analysis (mapping, planning, reviewing) and produces self-contained prompts that any LLM can execute — no tool use, no API keys, no vendor lock-in.

Install

npx claudecast

This copies ClaudeCast commands, agents, and hooks into ~/.claude/ where Claude Code auto-discovers them. Existing plugins (GSD, etc.) are untouched.

Requires: Claude Code installed, Node.js >= 16.7.0

Commands

| Command | What it does | Status | |---------|-------------|--------| | /cc:map | Analyze codebase structure, patterns, and conventions | Phase 2 | | /cc:plan | Generate model-agnostic prompts from the codebase map | Phase 3 | | /cc:queue | Manage prompt queue — list, reorder, copy, skip, track | Phase 4 | | /cc:review | Review generated code against prompt specifications | Phase 5 |

How It Works

/cc:map          Codebase → structured map (.state/current-map.json)
    ↓
/cc:plan         Map → ordered prompt sequence (.state/prompt-queue.json)
    ↓
/cc:queue        Copy prompts → paste into Gemini/GPT/etc.
    ↓
/cc:review       Generated code → verdict (PASSED / GAPS_FOUND / HUMAN_NEEDED)

Each prompt is self-contained: file paths, context snippets, input/output contracts, and inline examples — everything the target model needs without access to your repo.

Configuration

On first use, ClaudeCast creates .claudecast/config.json in your project:

{
  "granularity": "auto",
  "review_depth": "standard",
  "target_models": ["gemini-2.5-pro", "gpt-4o", "claude-sonnet"],
  "max_prompt_tokens": 32000
}

Edit directly or via CLI:

node ~/.claude/claudecast/bin/cc-tools.js config-set granularity '"per-feature"'
node ~/.claude/claudecast/bin/cc-tools.js config-get

Project Structure

claudecast/
├── bin/install.js              # Zero-dependency installer
├── package.json                # npm manifest (npx claudecast)
└── src/
    ├── commands/cc/            # Slash commands (/cc:map, /cc:plan, etc.)
    ├── agents/                 # Subagents (cc-mapper, cc-planner, cc-reviewer)
    ├── hooks/cc-statusline.js  # Status line hook
    └── claudecast/
        ├── bin/cc-tools.js     # CLI utility (config, state, artifact discovery)
        ├── defaults/config.json
        └── VERSION

Compatibility

ClaudeCast uses the cc: namespace for commands and cc- prefix for agents/hooks. It coexists with GSD, feature-dev, and any other Claude Code plugin without conflicts.

License

MIT