Pilot Shell

Name: Pilot Shell Review
Item: Pilot Shell
Rating: 3.4
Author: Aaron Matthews

Automation Development Usable

Works inClaude Code

Usable Reviewed

Wraps Claude Code in a professional dev environment that enforces linting, formatting, and type checking on every edit. Makes TDD mandatory, not optional.

Wraps Claude Code and Codex CLI in a spec-driven engineering workflow: /prd for requirements, /spec for plan-implement-verify with TDD, /fix for bugfixes, plus hooks that enforce linting, formatting, type checking, and tests as quality gates. Adds persistent context across sessions, semantic code search, a background automation agent, and a local web console.

Enforce linting and formatting on every file Claude edits
Make test-driven development mandatory in your coding workflow
Run code quality checks automatically without manual review

1,984 starsFreeDeveloper setup

Usable rating — This tool is functional but has notable gaps. Review the evaluation notes below before deploying.

Why it matters

Wraps Claude Code in a professional dev environment that enforces linting, formatting, and type checking on every edit. Makes TDD mandatory, not optional. Works fully offline with no telemetry. 1.6K stars.

Best for

Solo developers and small teams who want Claude to follow their existing code quality standards automatically, without manual review of every change.

Works in

Claude Code Claude Cowork Claude Chat

Source

https://github.com/maxritter/pilot-shell

By maxritter

How to Get It

Claude Code only: Hooks are configured in your project's .claude/settings.json file. They run automatically before or after Claude takes actions. You can ask Claude to set up a hook for you by describing what you want in your conversation. Not available in Claude Cowork or Claude Chat.

Command

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

Tip: Paste this into a Claude Code conversation. Verify command matches your Claude Code version.

First thing to try

After installing, paste this into Claude:

Help me enforce linting and formatting on every file Claude edits

PrerequisitesClaude Code via the native installer (uninstall npm/brew versions first) or Codex CLI, with an active subscription (Claude Max/Team for Claude Code; OpenAI Plus/Pro for Codex). macOS, Linux, or Windows WSL2.CostFree

Trust Signals Reviewed

Stars1,984Contributors12Last updated2026-08-16Known CVEsNone foundSources: GitHub Advisory Database + OSV.dev · Scanned 2026-08-16 · scanner v1

Data & Access

Data processingPrompts sent to Anthropic API. Enterprise/Team plans exclude training.

Community Pulse Active

Discussed on Hacker News, Reddit

In Russia, pilot involved in shelling of civilians in Ukraine was eliminated — Reddit · 3687 pts
The F35 Pilot gazes beyond your mortal Shell and into your Soul — Reddit · 3003 pts
Just Ukrainian pilot saves Mig-29 while Russians are shelling the runway — Reddit · 2926 pts

3 mentions across 1 sources

Reviewer notes

Reviewed review. These are observations, not a security certification.

Strong quality-gate discipline. Good for regulated/professional environments. Works with 50+ AI tools.

Things to check

Uses a license key (pilot activate, managed via the Polar members area) — check current pricing before assuming free. Requires the native agent installers; npm/brew-installed Claude Code must be removed first. Matching the quality gates to your team's linting/formatting rules takes configuration.

How to evaluate tools before deploying →

Data shown here comes from public APIs and automated scanning. Reviewer notes reflect one person's experience. This is not a security certification or legal recommendation. Always evaluate tools according to your own organization's policies.

Evaluation Scores

Evaluation

Ease of Use

3/5

Versatility

3/5

Reliability

4/5

Security

4/5

Overall score3.40 / 5.00 UsableEvaluatedApr 2026

Strong quality-gate discipline. Good for regulated/professional environments. Works with 50+ AI tools.

← Back to the Claude Observatory