Neura Market
pilot-shell logo

pilot-shell

Free

Make Claude Code production-ready — spec-driven plans, enforced quality gates, persistent knowledge

Coding AssistantsFreeFree tier
#TypeScript
Type
Open Source
Visit Website GitHub (1.6k stars)

About pilot-shell

Pilot Shell is a shell tool that enhances Claude Code and Codex agents for production-ready development. It introduces a spec-driven development workflow (/spec) for planning, approval, implementation, and verification. It enforces TDD by requiring tests before implementation, provides quality hooks for auto-formatting, linting, and type-checking, and offers persistent memory that carries context across sessions. Additional features include semantic code search, pre-wired MCP LSP servers, and worktree isolation for safe parallel work via git worktrees.

Key Features

Spec-Driven Development — Plan, approve, implement, verify with the /spec workflow
TDD Enforcement — Tests first, then implementation
Quality Hooks — Auto-format, lint, and type-check on every edit
Persistent Memory — Context carries across sessions automatically
Semantic Code Search — Find code by meaning, not just keywords
MCP LSP Servers — Pre-wired language tooling for both agents
Worktree Isolation — Safe parallel work via git worktrees

Pros & Cons

Pros
  • Enforces quality gates automatically (formatting, linting, type-checking)
  • Persistent memory maintains context across sessions
  • Spec-driven workflow ensures structured development
  • Semantic code search improves code understanding
  • Supports both Claude Code and Codex agents
  • Worktree isolation allows safe parallel work
Cons
  • Only works with Claude Code and Codex agents, not standalone
  • Requires git for worktree isolation feature
  • Primarily terminal-based, no graphical interface
  • May have learning curve for spec-driven workflow

Best For

Production-ready AI-assisted coding with Claude Code or CodexEnforcing test-driven development in AI-driven workflowsMaintaining code quality with automated linting and formattingCross-session context persistence for long-term projectsSafe parallel feature development using git worktrees

Alternatives to pilot-shell

agent-of-empires

Manage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding. Uses tmux a

Continue.dev

Open-source AI code assistant

ccpm

Project management skill system for Agents that uses GitHub Issues and Git worktrees for parallel agent execution.

awesome-ai-coding-tools

A curated list of AI-powered coding tools

AgentsMesh

The AI Agent Workforce Platform — where teams scale beyond headcount. Give every team member an AI agent squad.

antigravity-awesome-skills

Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill coll

FAQ

How do I install Pilot Shell?
Run the installer in your terminal: curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash
What AI agents does Pilot Shell support?
Pilot Shell is designed to enhance Claude Code and Codex agents.
What are the main features of Pilot Shell?
It includes spec-driven development, TDD enforcement, quality hooks, persistent memory, semantic code search, MCP LSP servers, and worktree isolation.