Skip to content

Commit 3b3a3ff

Browse files
committed
docs: fresh v0.9.7 screenshots + updated README
Screenshots (all 8 pages, fresh from v0.9.6 UI): - dashboard.png — health score, sparklines, trend chart, suggestions - prompts.png — user prompts + sessions with git context (NEW) - projects.png — comparison chart, efficiency bars - graph.png — D3.js with stats overlay - search.png — BM25 search with tips - agents.png — model cost indicators, layer architecture - files.png — size warnings (L/M badges) - security.png — 97% health score, risk distribution README updates: - How It Works: pipeline table with token/cost numbers - Token Savings: real CLI output with $ amounts - All 8 dashboard page descriptions updated for v0.9.x features - Added Prompts page screenshot (was missing)
1 parent 70d78ec commit 3b3a3ff

10 files changed

Lines changed: 40 additions & 68 deletions

File tree

README.md

Lines changed: 39 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -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
224194
Open 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 sessionsauto-updates via WebSocket.
197+
Health score, sparklines, 7-day trend chart, $ cost, smart suggestionsdark 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

docs/screenshots/agents.png

188 KB
Loading

docs/screenshots/dashboard.png

128 KB
Loading

docs/screenshots/files.png

159 KB
Loading

docs/screenshots/graph.png

251 KB
Loading

docs/screenshots/projects.png

158 KB
Loading

docs/screenshots/prompts.png

640 KB
Loading

docs/screenshots/search.png

185 KB
Loading

docs/screenshots/security.png

21.6 KB
Loading

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "codebase-pilot-cli",
3-
"version": "0.9.6",
3+
"version": "0.9.7",
44
"description": "Claude Code context engine — pack, compress, and optimize any codebase for AI. Save 60-90% tokens.",
55
"type": "module",
66
"main": "dist/index.js",

0 commit comments

Comments
 (0)