cckit

You're the architect. cckit runs the mechanics. The full GitHub work lifecycle — issues, worktrees, PRs, merges, multi-agent waves — as one CLI, drivable by Claude Code and any agent.

📖 Documentation · The idea · Tutorials · Quick start · Contributing · Code of Conduct

The whole idea in one line:

Turn your Git into retrievable, efficient context — using issues, GitHub Projects, and other people's tools, wired together with a few advanced mechanics.

You bring the ideas and the shape of the thing. The mechanics that make it stand up — branches, isolated worktrees, PRs, the merge flow, and the trail of issues that says why — are what cckit takes care of. It ships all of that as a single bash CLI plus a Claude Code plugin (skills, rules, agents), and it is agent-agnostic by design: Claude Code is first-class, but any agent that can run a shell can drive every operation.

Why

• One lifecycle, one source of truth. Start an issue, get an isolated worktree and branch, open a PR, merge, and clean up — each step is one command, correct by construction. The board is both the plan and the proof.
• Sessions that pick up where you left off. cckit handoff "<note>" saves a resume-here note; bare cckit prints it at the start of the next session — context survives the context window.
• Sessions that talk to each other. cckit msg send <branch|project:branch|all> [--steer] "<text>" mails any parallel session on the machine — same project or another; the kit's mail hook delivers it to a live session between tool calls, and a --steer message redirects a session that is about to stop.
• Agent-operable. Every verb has a machine-readable mode (cckit <verb> --llm) and an AGENTS.md contract, so agents drive the kit without scraping human output.
• Scales from one issue to a wave. The same verbs that take one issue to a merged PR also plan and run a whole wave of parallel agents — with a captain that gates and merges behind policy floors.
• Zero hard dependencies. Pure bash with graceful fallbacks; it auto-detects optional tools (gh, jq, fzf, gum) and degrades instead of failing.
• Portable. No company, framework, or repo is baked in — everything is driven from cckit.config.json.

Install

One-liner (macOS · Linux · WSL):

curl -fsSL https://raw.githubusercontent.com/jeiemgi/cckit/main/scripts/web-install.sh | bash

Homebrew:

brew tap jeiemgi/cckit && brew install cckit

npm (the bare cckit name is taken, so cckit is scoped):

npm install -g @jeiemgi/cckit

From source:

git clone https://github.com/jeiemgi/cckit.git
cd cckit && ./scripts/install.sh    # symlinks bin/cckit onto your PATH

Platforms & requirements

Platform	Supported
macOS	✅ native
Linux	✅ native
Windows	✅ via WSL or Git Bash (not native cmd/PowerShell)

Requirements: bash 4+, git, and gh (GitHub CLI) authenticated. jq recommended.

This is the beginning of the README. Read the rest at the original. Read the full README ↗