# maxritter/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.

Source: https://github.com/maxritter/pilot-shell
Indexed: commit 4b680e8 on 2026-09-01 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: JavaScript
- Stars: 2,149 at index time
- Code health: 5.7/10, Fair
- Last commit: 2026-09-01
- Contributors: 14

## How it 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.

- console/scripts/build-hooks.js: entry point
- console/src/services/server/Server.ts: entry point
- console/src/ui/viewer/App.tsx: entry point
- docs/site/api/trial/start.ts: entry point
- docs/site/dev.mjs: entry point
Modules: console, docs, pilot, launcher, installer, .github, root, scripts. 1,311 files, 116,074 lines, 6,721 symbols.

## Code health

- Score: 5.7/10 (Fair)
- Rank: #226 of 4,000+ indexed repos
- Hotspots: installer/steps/dependencies.py, installer/tests/unit/steps/test_dependencies.py, installer/tests/unit/steps/test_claude_files.py, pilot/ui/viewer-bundle.js, installer/tests/unit/steps/test_config_migration.py
- Lowest file: pilot/scripts/mcp-server.cjs
- Dead code: 215 findings

## Maintenance

- Last commit 2026-09-01, first commit 2025-10-24, 1,489 commits
- 14 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/maxritter/pilot-shell/security

## More

- Page: https://repowise.dev/repo/maxritter/pilot-shell
- Ask this codebase: https://repowise.dev/repo/maxritter/pilot-shell/chat
- Docs: https://repowise.dev/repo/maxritter/pilot-shell/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/maxritter/pilot-shell
