@@ -122,75 +122,45 @@ codebase-pilot service # auto-starts on login, tracks forever
122122
123123## How It Works
124124
125- <table >
126- <tr >
127- <td width =" 50% " >
128-
129- ** Architecture Pipeline**
130-
131- Your codebase goes through scan → detect → pack → compress → security scan → output. 98K tokens becomes 7K.
132-
133- <img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/diagrams/pipeline.png " alt =" How codebase-pilot works " width =" 100% " />
134-
135- </td >
136- <td width =" 50% " >
137-
138- ** Token Savings**
139-
140- Compression alone saves 70%. Add agent scoping for 93% reduction.
141-
142- <img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/diagrams/savings.png " alt =" Token savings comparison " width =" 100% " />
143-
144- </td >
145- </tr >
146- <tr >
147- <td width =" 50% " >
148-
149- ** Blast Radius Analysis**
150-
151- Change a file → see every dependent, transitive import, and affected test. Risk scored 0–100.
152-
153- <img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/diagrams/blast-radius.png " alt =" Blast radius analysis " width =" 100% " />
154-
155- </td >
156- <td width =" 50% " >
157-
158- ** Agent Layer Architecture**
159-
160- 7 layers — haiku for extraction, sonnet for implementation, opus for review gates.
161-
162- <img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/diagrams/agent-layers.png " alt =" Agent layer architecture " width =" 100% " />
163-
164- </td >
165- </tr >
166- <tr >
167- <td colspan =" 2 " >
125+ ```
126+ Your Codebase → scan → detect → pack → compress → security scan → AI-ready output
127+ 150K tokens → 41K tokens (~$0.12/prompt)
128+ ```
168129
169- ** Multi-Platform Support ** — one command generates configs for Claude Code, Cursor, Windsurf, and OpenAI Codex.
130+ ** The Pipeline: **
170131
171- <img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/diagrams/platforms.png " alt =" Multi-platform support " width =" 100% " />
132+ | Step | What happens | Impact |
133+ | ------| -------------| --------|
134+ | ** Scan** | Detect languages, frameworks, databases, test runners | 76 languages, 58 frameworks |
135+ | ** Pack** | Collect files, apply agent scoping, format as XML/MD | Structured AI context |
136+ | ** Compress** | Keep signatures, fold function bodies | 70% token reduction |
137+ | ** Security** | 180 pattern secret scan, auto-exclude detected files | Zero leaked credentials |
138+ | ** ` --affected ` ** | SHA-256 hash — only pack changed files | 95%+ savings on iterations |
139+ | ** ` --prune ` ** | Import graph traversal — minimum viable context | Only files that matter |
172140
173- </td >
174- </tr >
175- </table >
141+ ** Result:** 150K tokens → 41K packed → ** $0.12/prompt instead of $0.45** (saves $0.33 per prompt, ~ $36/week for active use).
176142
177143---
178144
179145## Token Savings
180146
181- The ` tokens ` command tracks your actual savings over time:
147+ ``` bash
148+ codebase-pilot pack --compress
182149
150+ Files: 104 packed
151+ Tokens: ~ 41,496 (compressed from ~ 150,810, 72% reduction)
152+ Cost: ~ $0 .12 per prompt (saved ~ $0 .33)
183153```
184- Savings estimate (per session):
185- Without codebase-pilot: ~98,798 tokens
186- With pack --compress: ~29,274 tokens
187- Pilot saves: ~69,524 tokens per session
188-
189- Your savings (from pack runs):
190- Today: 3 sessions — ~92,232 tokens saved
191- This week: 5 sessions — ~147,498 tokens saved
154+
155+ ``` bash
156+ codebase-pilot compare
157+
158+ Token impact: +16,845 tokens (+$0 .05 per prompt)
159+ Total now: 156,334 tokens (~$0 .47/prompt)
192160```
193161
162+ The dashboard tracks savings over time: ` $36.25 saved this week ` — real dollars, not abstract tokens.
163+
194164---
195165
196166## Web Dashboard
@@ -224,40 +194,42 @@ codebase-pilot service --uninstall
224194Open the dashboard days or weeks later — all your token history is already there.
225195
226196### Dashboard
227- Live stat cards (K/M/B abbreviated), savings chart, recent sessions — auto-updates via WebSocket .
197+ Health score, sparklines, 7-day trend chart, $ cost, smart suggestions — dark navy theme with animated gradient branding .
228198
229199<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/dashboard.png " alt =" Dashboard " width =" 100% " />
230200
231- ### Prompts (All Sessions)
232- User prompts from Claude Code + pack sessions with git context (branch, commit, dirty files). Click any row for detail drawer with token breakdown + savings bar.
201+ ### Prompts
202+ User prompts from Claude Code (via hooks) + all pack sessions with git context (branch, commit, dirty files). Click any row for detail drawer.
203+
204+ <img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/prompts.png " alt =" Prompts " width =" 100% " />
233205
234- ### Projects (System-Wide)
235- All projects in one view — sessions, tokens saved, efficiency per project .
206+ ### Projects
207+ Cross-project comparison chart, efficiency progress bars, savings by project. System-wide token tracking .
236208
237209<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/projects.png " alt =" Projects " width =" 100% " />
238210
239211### Import Graph
240- Interactive D3.js force-directed graph. Nodes sized by tokens, colored by module. Drag, zoom, search .
212+ Interactive D3.js force-directed graph with stats overlay (nodes, edges, directories). Click nodes for blast radius .
241213
242214<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/graph.png " alt =" Import Graph " width =" 100% " />
243215
244216### Search
245- Full-text search with BM25 ranking. Highlighted matches with file path + line number.
217+ Full-text BM25 search with quick-search tips, result count badge, highlighted matches with file path + line number.
246218
247219<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/search.png " alt =" Search " width =" 100% " />
248220
249221### Agents
250- Layer architecture, model assignment, context paths, dependencies .
222+ Summary stats with model cost indicators (Haiku $, Opus $$$$), layer architecture, agent cards with context paths .
251223
252224<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/agents.png " alt =" Agents " width =" 100% " />
253225
254226### Files
255- All files with token counts, language tags, percentage of total .
227+ File size warnings (red L >10K, orange M >5K tokens), language distribution, per-file token breakdown with lazy loading .
256228
257229<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/files.png " alt =" Files " width =" 100% " />
258230
259231### Security
260- Pattern categories , risk levels, detected secrets — side by side .
232+ 97% health score badge , risk distribution chart (critical/high/medium/low), pattern categories, detected secrets with drawer .
261233
262234<img src =" https://raw.githubusercontent.com/kalpeshgamit/codebase-pilot/main/docs/screenshots/security.png " alt =" Security " width =" 100% " />
263235
0 commit comments