MCP server
maxritter / pilot-shell
Professional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.
Claude Code, Cursor, Codex or VS Code. No key. You approve one sign-in in your browser.
Repowise maps public repos from their source. Not affiliated with maxritter. What is Repowise?
github.com/maxritter/pilot-shellIndexed at 4b680e8
What is pilot-shell?
pilot-shell is a professional context and harness engineering system for Claude Code and OpenAI Codex, used to build production-grade software. It keeps project knowledge, standards, prior decisions and session state available to the coding agent during long work. It wraps the agent's output in quality gates such as hooks, stop guards, independent reviews, test and build gates, and browser or device verification. The codebase is mostly TypeScript, with Python, JavaScript and shell scripts. Its code health is 5.7 out of 10 (Fair), ranked #214 of 4,000+ indexed repos. The last commit to pilot-shell was on Sep 1, 2026, and 14 people have contributed.
As of commit 4b680e8, indexed Sep 1, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.
For agentspilot-shell.md
Repo facts: type, license, health, rank, contributors
| Type | MCP server |
|---|---|
| Code health | 5.7 / 10 (Fair) |
| Health rank | #214 of 4,000+ indexed repos |
| Last commit | Sep 1, 2026 |
| Contributors | 14 |
| Bus factor | 1 |
| Size | 1,311 files, 116,074 lines |
Explore pilot-shell
- DocumentationModule-by-module documentation, 703 pages.
- ArchitectureDependency graph, layers and third-party dependencies.
- Code healthEvery file's score and the findings behind it.
- CommitsEach commit's effect on code health.
- OverviewEverything else the index found: contributors, decisions, what changed this week.
Ask about this code in your agent
This connects Repowise to pilot-shell's code. It does not install pilot-shell.
Useful if you want to change or fork pilot-shell: your agent can ask how it is put together and get answers that cite its files.
Ask about pilot-shell
Answers come from pilot-shell's README and source, with the files they cite. Two free answers a day without an account.
Want this for your own codebase? Map your repo free
About this page
Get a page like this for your own codebase
Repowise built this map of maxritter/pilot-shell from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.
Free for 2 public repos, with a page like this one. No card. See how Repowise works
Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub
maxritter/pilot-shell FAQ
What is pilot-shell?
pilot-shell is a professional context and harness engineering system for Claude Code and OpenAI Codex CLI. It adds persistent context, quality gates and runtime verification around the coding agent's work.
How does pilot-shell work?
pilot-shell integrates with Claude Code and Codex, using their rules, hooks, skills, subagents and MCP concepts. Its installer places hook scripts and shared assets under ~/.pilot and writes agent-specific files to each agent's config location.
What language is pilot-shell written in?
pilot-shell is written mostly in TypeScript by file count. Python, JavaScript and shell scripts are also present in the repository.
How is the pilot-shell code organized?
The code is split into modules named console, pilot, installer, launcher and docs. The console module holds the largest number of files, and the installer module contains the step scripts that set up each part of the system.
Who is pilot-shell for?
pilot-shell is for developers building production-grade software with Claude Code or Codex CLI who need durable context, disciplined implementation and proof that the finished system works.
Code health
Hotspots average 3.8, the place fixes pay off most.
On the leaderboards:#19 of 22 JavaScript repos
Key features of pilot-shell
- Persistent context keeps relevant source, architecture, project standards, prior decisions and session state available through long work and compaction.
- Quality gates use hooks, stop guards, independent reviews, and full test and build checks to stop unfinished work from being handed off as done.
- Browser or device verification checks the finished system at runtime.
- Spec-driven development and test-driven development are supported as part of the engineering process.
- A professional toolchain of Semble, CodeGraph, RTK, language servers, browser automation and MCP integrations supports code discovery, impact analysis and implementation.
How maxritter/pilot-shell works
The installer in the installer module runs as a sequence of steps, and each step is a script under installer/steps. The dependencies step in installer/steps/dependencies.py installs tools such as Semble, RTK, CodeGraph and the language servers. Hook scripts and managed assets are placed under ~/.pilot, and each agent's files are written to its own config location. The console module holds the Console, with console/src/services/server/Server.ts as its server entry point and console/src/ui/viewer/App.tsx as the entry point of its viewer interface. The build script console/scripts/build-hooks.js builds the hooks that the agents run during a session.
The codebase has 1,311 files and 6,721 symbols in 10 modules, mostly JavaScript by code size, with the most files in TypeScript. Code health is 5.7 out of 10, rated fair.
Maintain maxritter/pilot-shell?
Claim this page, add a badge to the README, or re-index it.
Claim this page
Sign in with GitHub and we check that you are an admin or maintainer of maxritter/pilot-shell. Then add a badge to the README that links readers here.
Add a badge to your README
Readers click through to this page and can ask pilot-shell's code a question. A badge also re-indexes the repo every week and marks you as the verified maintainer.
[](https://repowise.dev/repo/maxritter/pilot-shell?src=badge_ask)Paste it at the top of README.md, under the title.
Added it already? Verify to get the mark now instead of tomorrow.
Need HTML or the larger health card? More formatsHide more formats
This badge as HTML
<a href="https://repowise.dev/repo/maxritter/pilot-shell?src=badge_ask"><img src="https://api.repowise.dev/badge/wiki/maxritter/pilot-shell.svg?label=ask" alt="repowise: Ask this codebase"></a>Code health card
The score, its change since the last index, and when it was measured. Follows the reader's light or dark theme.
<a href="https://repowise.dev/repo/maxritter/pilot-shell?src=badge_card"><picture><source media="(prefers-color-scheme: light)" srcset="https://api.repowise.dev/badge/health/maxritter/pilot-shell.svg?style=card&theme=light"><img src="https://api.repowise.dev/badge/health/maxritter/pilot-shell.svg?style=card" alt="repowise code health" width="500" height="168"></picture></a>