The professional development environment for Claude Code — transforms Claude Code from powerful to reliable via spec-driven loops, 15 quality hooks, cross-session memory, and team knowledge sharing.
Pilot Shell is a professional development environment enhancement tool for Claude Code, designed to address reliability, context continuity, and team collaboration challenges in AI-assisted programming.
Core Capabilities#
Spec-Driven Development#
The /spec command provides a complete Plan → Approve → Implement (TDD) → Verify → Done loop, automatically detecting Feature/Bugfix modes. Bugfix mode includes Behavior Contract and test-before-fix workflow.
Quality Hooks Pipeline#
15 hooks covering 7 lifecycle events (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PreCompact, Stop, SessionEnd), automatically running formatting, linting, and type-checking after every file edit.
TDD Enforcement#
Failed tests must exist before modifying implementation files; non-blocking reminders cover Python/TypeScript/Go (extensible).
Cross-Session Memory#
PreCompact hook saves active plans/task lists/key decisions before compression; SessionStart hook restores them; persistent storage in local SQLite.
Intelligent Model Routing#
Opus by default for planning and verification phases; Sonnet for implementation; configurable per-component via Console Settings.
MCP Server Integration#
5 pre-configured servers (lib-docs, mem-search, web-search, grep-mcp, web-fetch), loaded on-demand to keep context lean.
LSP Support#
Python (basedpyright), TypeScript (vtsls), Go (gopls) with automatic install/configuration/restart.
Team Sharing#
/vault shares rules, commands, and skills via private Git repositories with versioning support (v1/v2/v3).
Online Learning#
/learn automatically or manually extracts tacit knowledge into reusable skills.
Worktree Isolation#
/spec tasks can execute in isolated git worktrees, with squash merge or discard on completion.
Typical Scenarios#
- Complex feature development (requires plan-approve-implement-verify loop)
- Bug fixes (Bugfix mode auto-triggers test-before-fix)
- Long-term project maintenance (cross-session memory preserves architectural decisions)
- Code quality assurance (auto lint/format/type-check on every edit)
- Team collaboration (share rules/skills via /vault)
- Parallel multitasking (multi-session + worktree isolation)
Prerequisites#
- Claude subscription (Max 5x/20x or Team Premium)
- Claude Code CLI installed
- Platform: macOS (10.15+) / Linux / Windows WSL2
Installation#
cd /path/to/your/project
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash
pilot
> /sync
Key Commands#
| Command | Purpose |
|---|---|
/spec "description" | Plan→Approve→Implement→Verify loop |
/sync | Build semantic index, discover conventions, update project docs and rules |
/learn | Extract tacit knowledge into skills |
/vault | Team sharing of rules/commands/skills |
Console Access#
- Local URL:
http://localhost:41777 - 7 views: Dashboard, Specifications, Memories, Sessions, Usage, Vault, Settings
Pricing#
- 7-day free trial
- Solo: $14/month
- Team: $35/seat/month