pilot-shell

How real engineers run Claude Code.

From requirement to production-grade code — planned, tested, verified. Spec-driven plans. Enforced quality gates. Persistent knowledge.

Install • Features • Docs • Blog • Website • Changelog

curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

macOS · 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 with an engineered solution:

• /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 — brainstorm ideas into clear requirements through 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

Run pilot for Spec-Driven Development with /spec, or pilot bot for 24/7 automations.

---

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.

---

GitHub에서 전체 내용 보기