codebase-pilot

Stop burning tokens. Start coding smarter.
AI context engine — pack, compress, optimize any codebase for LLMs. Zero cloud. Zero lock-in.

Installation

/plugin marketplace add kalpeshgamit/codebase-pilot
/plugin install codebase-pilot

npm install -g codebase-pilot-cli

npx codebase-pilot-cli init

brew install kalpeshgamit/codebase-pilot/codebase-pilot-cli

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

npm uninstall -g codebase-pilot-cli

Quick Start

# 1. Install
npm install -g codebase-pilot-cli

# 2. Set up your project
cd your-project
codebase-pilot init

# 3. Pack + compress for AI context
codebase-pilot pack --compress --copy

# 4. Scan for secrets before committing
codebase-pilot scan-secrets

# 5. See cost savings
codebase-pilot compare   # "+16K tokens (+$0.05/prompt)"

# 6. Open web dashboard
codebase-pilot ui    # → http://localhost:7456 (health score, trend charts, $)

# 7. (Optional) Install as always-on service
codebase-pilot service   # auto-starts on login, tracks forever

How It Works

Architecture Pipeline Your codebase goes through scan → detect → pack → compress → security scan → output. 98K tokens becomes 7K.	Token Savings Compression alone saves 70%. Add agent scoping for 93% reduction.
Blast Radius Analysis Change a file → see every dependent, transitive import, and affected test. Risk scored 0–100.	Agent Layer Architecture 7 layers — haiku for extraction, sonnet for implementation, opus for review gates.
Multi-Platform Support — one command generates configs for Claude Code, Cursor, Windsurf, and OpenAI Codex.

Token Savings

The tokens command tracks your actual savings over time:

  Savings estimate (per session):
    Without codebase-pilot:   ~98,798 tokens
    With pack --compress:      ~29,274 tokens
    Pilot saves:              ~69,524 tokens per session

  Your savings (from pack runs):
    Today:      3 sessions  — ~92,232 tokens saved
    This week:  5 sessions  — ~147,498 tokens saved

Web Dashboard

codebase-pilot ui               # → http://localhost:7456
codebase-pilot ui --stop        # stop daemon
codebase-pilot ui --status      # check status + diagnostics
codebase-pilot ui --port 8080   # custom port

Port 7456 = PILOT on phone keypad. Runs as background daemon with real-time WebSocket updates. Auto-fallback to next port if 7456 is in use.

Always-On Daemon