# agent-pulse

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 47600 installs · ★ 1 repo stars
- Author: Jane-o-O-o-O
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Jane-o-O-o-O/agent-pulse-skill/tree/HEAD/agent-pulse/SKILL.md
- Updated: 2026-05-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agent-pulse

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-pulse/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-pulse/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-pulse/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-pulse/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Jane-o-O-o-O/agent-pulse-skill agent-pulse
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-pulse/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Jane-o-O-o-O/agent-pulse-skill --path agent-pulse
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-pulse/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Jane-o-O-o-O/agent-pulse-skill --skill agent-pulse -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Jane-o-O-o-O/agent-pulse-skill/tree/HEAD/agent-pulse/SKILL.md

## When to use it
- 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
- 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

## Similar
- [ccam-analytics](https://affpapa.org/en/nevibecode/plugins/ccam-analytics.md) — plugin · ★ 1198 repo stars
- [cost-summary](https://affpapa.org/en/nevibecode/skills/cost-summary.md) — skill · 684 installs
- [cost-diff](https://affpapa.org/en/nevibecode/skills/cost-diff.md) — skill · 248 installs
- [telemetry](https://affpapa.org/en/nevibecode/skills/sethgammon-telemetry.md) — skill · ★ 937 repo stars
- [anomaly-alert](https://affpapa.org/en/nevibecode/skills/anomaly-alert.md) — skill · ★ 1198 repo stars
- [Agent Cost Report](https://affpapa.org/en/nevibecode/skills/agent-cost-report.md) — skill · 816 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
