Skip to main content
skill CX Codex

agent-pulse — Claude Code skill: monitor AI agents and costs

agent-pulse collects stats on sessions, tokens, tool calls and costs across local AI agents: Claude Code, Codex, Cursor, Copilot, Aider and more. Shows which session cost the most and which model ate the budget.

no license 47,600 installs ★ 1 updated 2026-05-28

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a claude-code
Open on GitHub

What agent-pulse does

The skill runs the agent-pulse CLI (PyPI package agentpulse-cli), which reads agent logs and outputs JSON with session counts, token usage, tool and search call counts, model and source breakdowns, and cost estimates. Requires Python and the installed package — the skill prompts you to run pip install agentpulse-cli if the command is missing from PATH. When the AI agent receives a question about status, budget, anomalies or cost forecast, the skill picks the right command (status, forecast, optimize, top, anomaly), applies platform (-P codex) and time filters (--hours 24), runs it and summarizes the result.

Includes commands for setup diagnosis (doctor), report export (Markdown, HTML, Prometheus), web dashboard and REST API (requires agentpulse-cli[web] extra), plus MCP mode so other AI clients can query Agent Pulse data. On Windows, the skill enables UTF-8 before running commands to render emoji and box drawing correctly.

What it helps with

  • find out how many tokens and dollars agents spent this week
  • identify the most expensive sessions and the models behind them
  • compare costs between two periods or across projects
  • check if spending stays within budget
  • forecast next month's costs and spot anomalies

Example prompts for the agent

  • Show agent status for the last 24 hours
  • What models were used this week and how much did they cost
  • Find the three most expensive sessions this week

How to install agent-pulse

1Skills CLI (Vercel)

npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a claude-code

2Manually: put the files in place

~/.claude/skills/agent-pulse/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-pulse/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-pulse

How to install agent-pulse in Claude Code?

Run npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a claude-code, the skill lands in ~/.claude/skills/agent-pulse/SKILL.md. Requires the agentpulse-cli Python package — the skill prompts you with pip install agentpulse-cli if the command is missing.

What does agent-pulse do?

Reads logs from local AI agents (Claude Code, Codex, Cursor, Aider, Copilot and others), counts tokens and tool calls, estimates costs using a built-in model pricing table. Outputs stats, top sessions, forecasts, anomalies and optimization tips.

How does agent-pulse calculate cost?

The CLI uses a local model price table and multiplies token counts by the rate. This is an estimate — actual bills depend on your provider's pricing. If the model is not recognized, no cost is calculated.

Similar skills

All skills for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open