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
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/agent-pulse/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agent-pulse/
1Skills CLI (Vercel)
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a codex2Manually: put the files in place
.agents/skills/agent-pulse/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a cursor2Manually: put the files in place
.cursor/skills/agent-pulse/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Jane-o-O-o-O/agent-pulse-skill agent-pulse2Manually: put the files in place
.github/skills/agent-pulse/SKILL.md1Skills CLI (Vercel)
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a gemini-cli2Platform CLI
gemini skills install https://github.com/Jane-o-O-o-O/agent-pulse-skill --path agent-pulseManually: put the files in place
.devin/skills/agent-pulse/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.