repowiserepowise

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.

★ 2,149stars on GitHubJavaScript

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
pilot-shell facts
TypeMCP server
Code health5.7 / 10 (Fair)
Health rank#214 of 4,000+ indexed repos
Last commitSep 1, 2026
Contributors14
Bus factor1
Size1,311 files, 116,074 lines

Explore pilot-shell

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

5.7out of 10Fair

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.