3rd/ccc

---

CCC is a launcher for Claude Code that lets you configure prompts, commands, agents, skills, hooks, MCPs, and plugins from a single place, in a layered way.

• Dynamic configuration: generate prompts, commands, agents, and skills in TypeScript with access to the current project.
• Layered config: merge global configuration with auto-detected presets and project overrides.
• Low‑effort extensibility: write hooks, MCP servers, statuslines, and workflows in TypeScript with tiny helpers.

Not affiliated with Anthropic. Uses the official @anthropic-ai/claude-code CLI.

Warning: Not tested on Windows, open an issue if you run into problems.

---

Getting Started

1. Setup

# clone this repo somewhere you'd like to keep going to edit your configuration
git clone https://github.com/3rd/ccc.git ~/my-claude-launcher
cd ~/my-claude-launcher

# install dependencies and link `ccc`
bun install
bun link

Requirements:

• Bun on PATH. ccc runs under Bun, and so do config loading, hooks, inline MCPs, and the statusline.
• Node.js 24 or newer on PATH, or set CCC_NODE to a Node binary. Claude Code itself runs under Node.
• Optional, Linux only: unshare (util-linux 2.38+) and a C compiler (cc). With them, child processes such as Bash tool commands also see your generated config (see How It Works). Without them, CCC skips that step and still works.

Claude Code version: @anthropic-ai/claude-code is pinned to an exact version in package.json, so bun update leaves it unchanged. To try another release, run bun add @anthropic-ai/claude-code@; at startup, CCC lists any runtime patch that no longer matches as stale. To run a different Claude Code executable without changing the dependency, set CLAUDE_PATH. CCC supports Claude Code 2.1.242 and later.

2. Customize your config

Your configuration lives in ./config, which ships with examples:

~/my-claude-launcher/     # Your copy of this repository
└── config/
    ├── global/           # Applies everywhere
    │   ├── prompts/      # system.ts (system prompt) and user.ts (CLAUDE.md)
    │   ├── commands/     # Slash commands
    │   ├── agents/       # Sub-agents
    │   ├── settings.ts   # Claude Code settings plus CCC-only keys
    │   ├── hooks.ts      # Hooks
    │   ├── mcps.ts       # MCP servers
    │   └── statusline.ts # Statusline
    └── presets/          # Language/framework/whatever-specific configs
        ├── golang/
        ├── rust/
        └── typescript/