Repository avatar
Other Tools
v1.2.0
active

agent-cost-analyzer

io.github.raulkivi/agent-cost-analyzer

Local, read-only analysis of agentic coding costs, caching and sessions from your own logs.

Documentation

Agent Cost Analyzer

Last changed: 2026-11-19 · Source: https://github.com/raulkivi/agent-cost-analyzer

Works with GitHub Copilot Chat Works with Claude Code Works with pi

Independent project; not affiliated with or endorsed by GitHub, Microsoft, Anthropic or the pi project. Product names are trademarks of their owners.

See where the tokens and money go when an AI agent writes code for you. This repository gives you two products that read the logs your coding agents already write on your own machine and show every session turn by turn:

  • AI Credits Analyzer is a VS Code extension for GitHub Copilot Chat and its AI Credits.
  • Agent Cost Analyzer is a standalone app for Claude Code, GitHub Copilot and the pi coding agent.

Both run locally and are read-only. Nothing leaves your machine.

The AI Credits Analyzer extension in VS Code after a Copilot chat: the new session under Today in Sessions with its AI Credits and tooltip, and today's AI Credits in the status bar

What you can find out

  • What a session, a repository or a project cost, and how that changed over time.
  • Why a cost changed: more usage, a price change, or a different model mix.
  • What a real session would have cost on another model.
  • Which tool calls failed and why, which commands were risky, and which sessions look unusual.
  • Which changes would lower your spend: the Savings report ranks them, each with an estimated weekly range or "up to" figure. The standalone app covers all its sources; the extension covers GitHub Copilot sessions.
  • How much of a monthly AI Credits allowance you have used, in both products. Set the allowance and the extension's status bar, or the standalone app's header in Analyze mode, shows the month to date against it, with a warning near the limit. The extension's Sessions view shows the same figures with the days left; the app's details dialog also gives the days left and the Copilot Chat and Agent Host split, and an MCP tool answers the same question for an AI chat. It counts GitHub Copilot sessions only, on this machine.
  • How prompt caching, context compaction and model switches change what a turn costs. Learn mode explains this with sample sessions, so it is useful before you have any data of your own.
  • All of the above from an AI chat, through a read-only MCP server (see Ask your AI chat).

Which one do I need?

You useInstall
GitHub Copilot Chat in VS CodeAI Credits Analyzer, the extension
Claude Code, pi, or several tools at onceAgent Cost Analyzer, the standalone app (it reads Copilot Chat sessions too)

Get started: AI Credits Analyzer (VS Code)

  1. Install AI Credits Analyzer from the VS Code Marketplace, or from Open VSX for VSCodium and similar editors. It needs VS Code 1.146 or later and GitHub Copilot Chat.
  2. Turn on Copilot Chat's debug file logging, so Copilot Chat records token and AI Credits data. The extension's Setup view has a Fix button that opens the setting (github.copilot.chat.agentDebugLog.fileLogging.enabled), and a walkthrough opens on first start. Newer chats that run through Copilot's Agent Host don't need it.
  3. Chat with Copilot as usual, then pick a session in the Sessions view.

Full steps, commands and settings: the extension guide.

Get started: Agent Cost Analyzer (standalone app)

Needs Node.js 22.18 or newer.

npx agent-cost-analyzer

A terminal runs npx agent-cost-analyzer: the app starts on 127.0.0.1:5199 and opens in the browser, Analyze mode lists sample sessions, and a second run opens the running app instead of starting another

It starts the app on http://127.0.0.1:5199 and opens it in your browser. npx agent-cost-analyser (British spelling) also works: it is an alias of the same package. The server listens on your own machine only. If the app is already running, a second start opens that one; if another program holds port 5199, it takes the next free port and says which. Options:

  • --port <n> uses that port only (0 takes any free port).
  • --no-open starts without opening a browser.
  • --help and --version do what they say. npx agent-cost-analyzer@latest runs the newest release.

To keep a fixed version, or to start it without the npm registry, install it once with npm install -g agent-cost-analyzer and run agent-cost-analyzer (or agent-cost-analyzer mcp).

Learn mode works straight away. Switch to Analyze mode and pick a source (VS Code Copilot Chat, Claude Code or pi) to see your own sessions. Claude Code and pi need no setup, because the app reads their session files directly.

The app writes only its own settings folder: ~/.config/agent-cost-analyzer on Linux (or under XDG_CONFIG_HOME), ~/Library/Application Support/agent-cost-analyzer on macOS and %APPDATA%\agent-cost-analyzer on Windows. It holds your chosen provider, the retention threshold, your projects file and issued statements.

To ask an AI chat about your sessions, connect the app's MCP server: see Ask your AI chat.

The standalone app on load, with Learn and Analyze modes

From source (contributors)

To work on the app, or to install the pi logger, run it from a clone. This needs the whole dev tree (Vite, Playwright, esbuild).

git clone https://github.com/raulkivi/agent-cost-analyzer.git
cd agent-cost-analyzer
npm install
npm start

npm start runs the Vite dev server and the API with reload, and opens http://127.0.0.1:5173.

More: setup and data sources (where each tool keeps its logs, the Copilot Chat settings, a one-paste setup prompt for an AI coding agent) and the User Guide (a screen-by-screen tour).

Ask your AI chat

Both products include a local, read-only MCP server. Connect it to Claude Code, Claude Desktop or Copilot Chat and ask "what drove my spend this week?" or "which commands failed most?". In hosts that support MCP Apps, such as Claude Desktop and VS Code Copilot Chat, the cost and findings answers also show interactive views.

Copilot agent mode answering "What drove my spend this week?" with a cost rollup view in the chat, then one top session drilled down to its turns

Claude Desktop shows a month's cost for every provider at once, and opens the view in a side pane.

Claude Desktop answering "What did my coding agents cost in October?" with a cost rollup for Claude Code, Copilot and pi, opened in the side pane, then one session and one turn

To connect the standalone app's server:

npx agent-cost-analyzer mcp install
  • It finds Claude Code, Claude Desktop, Cursor, VS Code, Codex and Gemini CLI on your machine, shows each command and file it will change, and asks first. It backs up each config file it edits; mcp uninstall removes the entry again and mcp status shows where it is registered.
  • The app's Connect an agent button shows the same setup per client, to copy and run yourself.
  • Other options: a Claude Code plugin, a Claude Desktop .mcpb bundle and the MCP Registry listing.

Every option, setup by hand, Windows and offline use: Connecting an AI chat (MCP) in the User Guide.

For the extension, turn on the aiCreditsAnalyzer.mcp.enabled setting. See the MCP server for Copilot agent mode.

Privacy and your data

  • Everything runs on your machine. Neither product sends your data anywhere or reports telemetry.
  • They only read: your tools' own session logs (Copilot Chat's session store and debug logs, ~/.claude/projects/, ~/.pi/agent/sessions/, and optionally, mitmproxy captures you export yourself). They never change those files or your tools' settings. The one exception is mcp install and mcp uninstall, which edit your MCP clients' config when you run them.
  • Exporting a session for AI advice copies metadata only (token usage, cache efficiency, tool usage, AI Credits). It never includes your chat text.

What the extension reads, file by file: Privacy and what the extension reads.

Learn more

License

MIT

Contributing / developer documentation: CONTRIBUTING.md and docs/README.md.