{"id":"maxritter-pilot-shell","name":"pilot-shell","homepage":"https://pilot-shell.com","repo_url":"https://github.com/maxritter/pilot-shell","category":"devtools","subcategories":[],"tags":["ai-agents","ai-coding-tools","claude-code","spec-driven-development","tdd","developer-tools","cli"],"what_it_does":"Pilot Shell is an installation/CLI wrapper around Claude Code that provides a structured “spec-driven development” workflow (plan/approve/implement/verify), enforced quality hooks (lint/format/typecheck), git worktree-based task isolation, and a local dashboard for session/spec/review/status visibility.","use_cases":["Coding tasks where you want spec-driven planning and verification instead of free-form agent chatting","Reducing regressions by enforcing TDD and running full test suites during agent work","Review-gated changes with interactive annotations (spec approval and inline diff review)","Headless/CI automation of Claude Code workflows using a non-interactive flag","Project bootstrapping of rules/hooks/MCP servers via /setup-rules"],"not_for":["Teams that cannot run local CLI tooling or that require a purely remote SaaS workflow","Workflows that do not use git or where worktree-based isolation is not feasible","Environments that cannot install browser automation components or required language servers","Use as a general-purpose external API service (it is primarily a local dev tool)"],"best_when":"You are already using Claude Code and want stronger engineering discipline (TDD, verification, review gates) with a consistent workflow across sessions and projects.","avoid_when":"You need a simple chat interface only, or you cannot accommodate local installation, hooks, and test execution as part of the agent loop.","alternatives":["Claude Code without Pilot Shell (built-in plan/commands/hooks only)","Other agent frameworks with custom scaffolding and orchestration (varies by vendor/tooling)","Local dev tooling centered on CI/test enforcement (e.g., pre-commit + CI gates) combined with any coding agent"],"af_score":43.2,"security_score":47.8,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:23:26.312751+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Claude subscription/auth via claude auth status (as referenced in README for tier detection)"],"oauth":false,"scopes":false,"notes":"Pilot Shell appears to rely on Claude Code’s existing authentication model; README does not specify OAuth flows or fine-grained scope management for Pilot itself."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":["Claude subscriptions (Solo/Max/Team Premium/Enterprise) referenced for usage tiering"],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"README discusses Claude subscription tiers for usage; it does not state a separate Pilot Shell pricing model."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":43.2,"security_score":47.8,"reliability_score":36.2,"mcp_server_quality":45.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":75.0,"rate_limit_clarity":10.0,"tls_enforcement":60.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":60.0,"secret_handling":45.0,"security_notes":"Pilot Shell downloads and runs installer scripts (curl | bash pattern) and installs multiple tools (language servers, browser automation, dependencies). README does not provide detailed guidance on secret storage/redaction, least-privilege scopes, or threat modeling of local execution. It integrates with Claude/Claude Code auth via external subscription status rather than specifying its own auth mechanism.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":30.0,"error_recovery":60.0,"idempotency_support":"true","idempotency_notes":"Installer claims rollback on failure and idempotent re-runs; uninstall removes managed files and aliases.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Requires local environment setup (dependencies, language servers, hooks); failures may occur if prerequisites can’t be installed/initialized.","Worktree-based implementation and browser automation for UI E2E may be slow/fragile in constrained environments.","Headless mode changes interaction style; agent assumptions about interactive approval may not hold without proper flags."]}}