wtcraft
Git-native governance for running Claude Code, Codex & Gemini together — on a budget
Run Claude Code, Codex, and Gemini side by side in isolated git worktrees, with strict, verifiable task boundaries that keep them from stepping on each other — instead of reinventing another runtime.
Install
# Node / npm
npm install -g wtcraft
# Python / pipx (recommended)
pipx install wtcraft
# Homebrew (macOS)
brew tap zywkloo/wtcraft https://github.com/zywkloo/wtcraft && brew install wtcraft
Then run wtcraft init in your repo root to scaffold the harness.
Articles · TokenChef
- 👨🍳 TokenChef (Part 01)
Vibe Coding with Git Worktrees — A Playbook Most Devs Are Missing
Most people vibe-code with one model in one branch. Here is how to use multiple models, git worktrees, and a phased workflow to ship refactors without breaking everything.
- 👨🍳 TokenChef (Part 02)
Chief Token Orchestrator — Manage Claude, Codex, and Gemini as a Structured Software Team
Spawning parallel agents is easy. Spawning them without hitting token limits, context pollution, or review bottlenecks is hard. Discover why you need a structured, layered team architecture.
- 👨🍳 TokenChef (Part 03)
wtcraft — A Lightweight, Git-Native Governance Core for Claude Code, Codex, and Gemini
How do you actually enforce boundaries on autonomous agents? Explore Harness Engineering, the competitive landscape of task contracts, and how the wtcraft CLI implements bounded sandboxes locally.
- 👨🍳 TokenChef (Part 04)
Stop Reinventing the Agent — wtcraft Boundaries, Ledgers & Sign-off First
An architectural comparison of Codex and Claude Code shows we don't need another agent runtime — wtcraft should enforce task boundaries, execution ledgers, and sign-offs.
FAQ
What is wtcraft?
wtcraft is a lightweight, git-native CLI that lets you run multiple coding-agent CLIs — Claude Code, Codex, Gemini — side by side in isolated git worktrees, with strict, verifiable task boundaries that keep them in their lanes and on budget. No daemon or database — state lives in git.
How is wtcraft different from plain git worktrees or Claude Code's --worktree?
Raw worktrees give you isolation but leave token budget, file scope, and task handoff up to you. wtcraft adds the missing contract layer: a per-task .worktree-task.md with explicit Scope and Off-limits blocks, plus a run ledger and a sign-off step.
Does wtcraft work with Claude Code, Codex, and Gemini?
Yes. wtcraft is agent-agnostic scaffolding; run `wtcraft init --patch-agent-files` to opt into integration with Claude Code, OpenAI Codex, or the Gemini CLI.
How do I install wtcraft?
Install globally via npm (npm install -g wtcraft), pipx (pipx install wtcraft), or Homebrew, then run `wtcraft init` in your repository root.