Pilot Shell
Make Claude Code production-ready — spec-driven plans, enforced quality gates, persistent knowledge
Rating
Votes
0
score
Downloads
0
total
Price
Free
API key required
Works With
About
Make Claude Code production-ready.
From requirement to production-grade code — planned, tested, verified. Spec-driven plans. Enforced quality gates. Persistent knowledge.
](https://github.com/maxritter/pilot-shell/stargazers) [ ](https://github.com/maxritter/pilot-shell/releases) [
Install • Features • Console • Docs • Website • Changelog
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bashmacOS · Linux · Windows (WSL2) — installs in under 2 minutes.
Why Pilot Shell
Claude Code writes code fast — but without structure, it skips tests, loses context, and produces inconsistent results. Other frameworks add complexity (dozens of agents, thousands of lines of config) without meaningfully better output.
Pilot Shell is different. Every component solves a real problem:
- `/spec` — plans, implements, and verifies features end-to-end with TDD
- `/prd` — turns vague ideas into clear requirements with optional deep research
- Quality hooks — enforce linting, formatting, type checking, and tests as gates (not suggestions)
- 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
- Console — local web dashboard with real-time notifications and session management
- Pilot Bot — persistent automation agent with scheduled tasks and background jobs
Run pilot for Spec-Driven Development with /spec, or pilot bot for 24/7 automations.
Getting Started
Prerequisites
Claude Code: Install Claude Code using the native installer before setting up Pilot Shell. If you have the npm or brew version installed, uninstall it first. If no Claude Code installation is detected, the Pilot installer will attempt to set it up for you.
Claude Subscription: Solo developers should choose Max 5x for moderate usage or Max 20x for heavy usage. Teams should use Team Premium (6.25x usage per member, SSO, admin tools, billing management). Companies with stricter compliance or procurement requirements should use Enterprise (API based pricing applies per usage).
Terminal (Recommended): cmux works great with Pilot Shell — its vertical tab layout lets you run multiple sessions side by side. Any modern terminal works: Ghostty, iTerm2, or the built-in macOS/Linux terminal.
Don't lose this
Three weeks from now, you'll want Pilot Shell again. Will you remember where to find it?
Save it to your library and the next time you need Pilot Shell, it’s one tap away — from any AI app you use. Group it into a bench with the rest of the team for that kind of task and you can pull the whole stack at once.
⚡ Pro tip for geeks: add a-gnt 🤵🏻♂️ as a custom connector in Claude or a custom GPT in ChatGPT — one click and your library is right there in the chat. Or, if you’re in an editor, install the a-gnt MCP server and say “use my [bench name]” in Claude Code, Cursor, VS Code, or Windsurf.
a-gnt's Take
Our honest review
Make Claude Code production-ready — spec-driven plans, enforced quality gates, persistent knowledge. Best for anyone looking to make their AI assistant more capable in knowledge bases. It's completely free and works across most major AI apps. This one just landed in the catalog — worth trying while it's fresh.
Tips for getting started
Tap "Get" above, pick your AI app, and follow the steps. Most installs take under 30 seconds.
Heads up: this needs an API key to work. You'll get one from the service's website (usually free). The setup guide tells you exactly where.
What's New
Imported from GitHub
Ratings & Reviews
0.0
out of 5
0 ratings
No reviews yet. Be the first to share your experience.