Agentic Guide

Beautiful local AI usage dashboard for developers. Agentic Guide is a revised fork of CodeBurn with the same strong local parsers, pricing/export foundation, and a new model-focused interface.

Everything runs locally. It reads AI coding session artifacts from disk, estimates token cost, and shows usage by provider, model, project, session, activity, tool, MCP server, and shell command.

Install

npm install -g agentic-guide
agentic-guide

Short alias:

ag-ai

Usage

agentic-guide                        # interactive dashboard
agentic-guide scan                   # same dashboard, explicit scan command
agentic-guide today                  # today's usage
agentic-guide month                  # this month's usage
agentic-guide report -p 30days       # rolling 30-day window
agentic-guide report --format json   # website/import-ready JSON
agentic-guide export -f json         # export Today, 7 Days, 30 Days
agentic-guide compare                # model comparison
agentic-guide optimize               # token waste findings
agentic-guide status --format json   # compact machine-readable status

Interactive Controls

• 1 2 3 4 5: Today, 7 Days, 30 Days, Month, All Time
• Left/right arrows: switch date range
• m: cycle model spotlight and monster profile
• p: switch provider when multiple providers are detected
• c: compare models
• o: open optimize findings
• q: quit

Model Monsters

The dashboard gives each model family a visual “monster” profile. Each profile shows:

• Model name and raw provider model id
• Cost, calls, sessions, projects
• Energy bar based on relative spend
• Spend rank, spend share, average cost per call, cache hit rate
• Top project, output/input ratio, total tokens, last-seen date

Usage Forecast

The dashboard shows real-data burn rate and refresh state. If you configure a plan, it also shows projected month-end usage, remaining safe daily spend, estimated time to hit the limit, reset date distance, and next auto-refresh countdown.

agentic-guide plan set claude-max
agentic-guide plan set custom --monthly-usd 50 --provider all
agentic-guide scan --refresh 15

This is designed for importing into agenticguide.org later: agentic-guide report --format json already exposes model, daily, project, activity, shell command, MCP, and session data.

Supported Data Sources

Agentic Guide inherits CodeBurn provider support including Claude Code, Codex, Cursor, Cursor Agent, Gemini CLI, GitHub Copilot, OpenCode, OpenClaw, Pi, OMP, Kiro, Droid, Roo Code, KiloCode, and Qwen.

Attribution

Agentic Guide is a modified fork of CodeBurn by AgentSeal. CodeBurn is MIT licensed. This fork keeps the same local-first privacy model and parser architecture while adding Agentic Guide branding and model monster UX.