---
url: https://fewknowme.github.io/ctxpilot
access_date: 2026-03-17T05:54:40.000Z
current_date: 2026-03-17T05:54:40.039Z
---

# Your AI already knows  
your codebase.

 ctxpilot builds a living summary of your project and injects it into every AI tool you use. Auto-updates after every git commit. Works with Cursor, Claude Code, Codex, and Windsurf.

$ `npm install -g @ctxpilot/ctxpilot` 

MIT License TypeScript MCP Protocol Anthropic + OpenAI Open Source 

---

What it looks like

\~ ctx init 

 Scanning project... reading git log, package.json, source files

 LCD generated. 847 tokens. .ctxpilot/context.md written.

  
\~ ctx setup 

 Configured: Claude Code, Codex CLI, Cursor, Windsurf

 CLAUDE.md written. Codex skill created. Cursor + Windsurf rules written.

  
\~ ctx watch 

 Daemon started. Watching .git/refs/heads/ for commits...

Auto-update will run 30s after each commit.

Fresh Codex session — zero context pasted

 Asked:**"What is this project and what am I working on?"** 

  
Codex responded:

  
 "Minimum per-item quantity is hardcoded as **6** in several places,

 and the store silently coerces values with**Math.max(quantity, 6)** 

 in **cart.ts#L40** and **cart.ts#L70**."

  
 Exact file. Exact line numbers. Private codebase. Zero explanation given.

---

## Three commands to set up

Step 1

`ctx init` 

 Scans your codebase with AI. Builds a Living Context Document from your files, git history, and answers to 3 quick questions.

Step 2

`ctx setup` 

 Hooks into every AI tool you have installed. Writes MCP configs, CLAUDE.md, Cursor rules, and Codex skills automatically.

Step 3

`ctx watch` 

 Starts a background daemon. Detects git commits. Auto-updates the LCD. You never run ctx update manually again.

---

## Works with your tools

 ctx setup auto-detects installed clients and writes configs in one command.

Claude Code

MCP + CLAUDE.md

Cursor

MCP + .cursor/rules/

Codex CLI

MCP + agent skill

Windsurf

MCP + .windsurf/rules/

---

## Commands

| ctx init          | Scan codebase and build the first LCD                      |
| ----------------- | ---------------------------------------------------------- |
| ctx setup         | Write MCP configs and rule files for all installed clients |
| ctx watch         | Start background daemon, auto-update on git commits        |
| ctx update        | Run one incremental update now                             |
| ctx build         | Rebuild LCD from scratch, archive previous                 |
| ctx show          | Print current LCD with token count                         |
| ctx inject        | Output LCD as XML/markdown/plaintext for manual paste      |
| ctx signal "text" | Add a manual note for next update                          |

---