Pilot Shell: A Structured Workflow Layer for Claude Code
Pilot Shell is an open-source layer installed on top of Claude Code that enforces structured workflows for planning, fixing, and brainstorming. It addresses common pain points like skipped tests, lost context, and inconsistent output while avoiding the overhead of frameworks that require dozens of agents or thousands of config lines.
Key Components
/spec— Plans, implements, and verifies features end-to-end with TDD./fix— Bugfix workflow with TDD; bails out when complexity exceeds the standard fix lane./prd— Brainstorms ideas into clear requirements with optional deep research.- Quality hooks — Enforce linting, formatting, type checking, and tests as quality gates.
- Context engineering — Preserves decisions and knowledge across sessions.
- Code intelligence — Semantic search (Probe) + code knowledge graph (CodeGraph).
- Token optimization — 60–90% cost reduction via RTK and context-mode.
- Extensions — Reusable rules, skills, and MCP servers with team sharing and customization.
- Console — Local web dashboard with real-time notifications and session management.
- Pilot Bot — Persistent automation agent with scheduled tasks and background jobs.
Installation
Works on macOS, Linux, and Windows (WSL2). Installs globally with a single command:
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash
All tools and rules go to ~/.pilot/ and ~/.claude/. After installation, run pilot or ccp in any project directory.
Who It's For
Developers who already use Claude Code and want structured, repeatable workflows without switching to a heavy agent framework.
📖 Read the full source: r/ClaudeAI
👀 See Also
Caveman: A Claude Code Skill That Cuts 75% of Tokens by Using Caveman-Style Speech
Caveman is a Claude Code skill that reduces token usage by approximately 75% by making Claude respond in a concise, caveman-like style while maintaining full technical accuracy. It's installed via npx or the Claude plugin marketplace.
Using /probe to catch AI hallucinations before writing code
A developer shares a technique called /probe that forces AI-generated plans to make numbered claims with expected values, then probes the real system to catch discrepancies. The method caught four factual errors in Claude's description of its own JSONL format that would have caused code bugs.
Governor: A Claude Code Plugin to Cut Token Waste via Output Compression, Context Slimming, and Tool Filtering
Governor is a Claude Code plugin that reduces token/context waste through compact professional output, memory file compression, tool-output filtering, and drift guardrails. Benchmarks show 55.5% output token savings vs control.
CTOP: Terminal UI to Monitor Claude Code Sessions, Zero Deps
CTOP is a zero-dependency Node.js TUI that shows CPU, memory, context window saturation, token breakdown, and cost estimates for all running Claude Code and Codex sessions.