agent-pulse

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Agent Pulse

Purpose

用途

Use the installed

agent-pulse

CLI as the source of truth for local AI-agent activity. The PyPI package is

agentpulse-cli

, while the command remains

agent-pulse

. Prefer running commands and summarizing their output over reading the Agent Pulse source code.

Always enable UTF-8 on Windows before running commands because Agent Pulse output contains emoji and box drawing:

powershell

$env:PYTHONUTF8='1'
$env:PYTHONIOENCODING='utf-8'

agent-pulse

is not on PATH, ask before installing dependencies. If the user approves, install the PyPI package or try running from a local project checkout:

powershell

pip install agentpulse-cli

powershell

python -m agent_pulse.cli --version

将已安装的

agent-pulse

CLI作为本地AI-agent活动的权威数据源。PyPI包名为

agentpulse-cli

，而命令仍为

agent-pulse

。优先选择运行命令并汇总输出，而非阅读Agent Pulse的源代码。

在Windows上运行命令前务必启用UTF-8，因为Agent Pulse的输出包含表情符号和框线绘制字符：

powershell

$env:PYTHONUTF8='1'
$env:PYTHONIOENCODING='utf-8'

如果

agent-pulse

不在PATH中，请先询问用户是否同意安装依赖。若用户同意，可安装PyPI包或尝试从本地项目检出目录运行：

powershell

pip install agentpulse-cli

powershell

python -m agent_pulse.cli --version

Source Keys

源平台标识

Use

-P/--platform

when the user asks about one agent tool instead of all local data:

text

hermes, claude, codex, deepseek, openclaw, copilot, aider, qwen,
opencode, goose, cursor, antigravity, amp

当用户询问单个agent工具而非所有本地数据时，使用

-P/--platform

参数：

text

hermes, claude, codex, deepseek, openclaw, copilot, aider, qwen,
opencode, goose, cursor, antigravity, amp

Choose Commands

命令选择

Use this command selection table first:

User wants	Run
Current status	`agent-pulse status --json`
Full dashboard	`agent-pulse --json` or `agent-pulse --no-banner`
Demo data	`agent-pulse demo --json`
Setup diagnosis	`agent-pulse doctor --json`
Recent sessions	`agent-pulse --json --hours 24 --limit 20`
Top sessions	`agent-pulse top --sort tokens --json`
Top expensive sessions	`agent-pulse top --sort cost --json --hours 168`
Model cost analysis	`agent-pulse models --json`
Model ranking	`agent-pulse leaderboard --json --rank-by efficiency`
Cost savings	`agent-pulse optimize --json`
Budget status	`agent-pulse budget --json`
Cost forecast	`agent-pulse forecast --json`
Cost anomaly check	`agent-pulse anomaly --json`
Health/CI check	`agent-pulse health --json`
Composite score	`agent-pulse score --json`
Search sessions	`agent-pulse search "<query>" --json`
Compare periods	`agent-pulse compare --json`
Compare projects	`agent-pulse compare-projects --json`
Activity calendar	`agent-pulse heatmap --json`
Smart recommendations	`agent-pulse insights --json`
Prometheus metrics	`agent-pulse metrics --format prometheus`
Export report	`agent-pulse export -f markdown` or `agent-pulse export-html`
Web dashboard	`agent-pulse web --port 8765`
REST API	`agent-pulse api --port 8766`
MCP tools	`agent-pulse mcp --list-tools`

If the installed command lacks an option, run

agent-pulse <command> --help

and adapt.

首先参考以下命令选择表：

用户需求	运行命令
当前状态	`agent-pulse status --json`
完整仪表盘	`agent-pulse --json` 或 `agent-pulse --no-banner`
演示数据	`agent-pulse demo --json`
设置诊断	`agent-pulse doctor --json`
近期会话	`agent-pulse --json --hours 24 --limit 20`
热门会话	`agent-pulse top --sort tokens --json`
高成本会话	`agent-pulse top --sort cost --json --hours 168`
模型成本分析	`agent-pulse models --json`
模型排名	`agent-pulse leaderboard --json --rank-by efficiency`
成本优化建议	`agent-pulse optimize --json`
预算状态	`agent-pulse budget --json`
成本预测	`agent-pulse forecast --json`
成本异常检测	`agent-pulse anomaly --json`
健康/CI检查	`agent-pulse health --json`
综合评分	`agent-pulse score --json`
会话搜索	`agent-pulse search "<query>" --json`
时段对比	`agent-pulse compare --json`
项目对比	`agent-pulse compare-projects --json`
活动日历	`agent-pulse heatmap --json`
智能建议	`agent-pulse insights --json`
Prometheus指标	`agent-pulse metrics --format prometheus`
导出报告	`agent-pulse export -f markdown` 或 `agent-pulse export-html`
Web仪表盘	`agent-pulse web --port 8765`
REST API	`agent-pulse api --port 8766`
MCP工具	`agent-pulse mcp --list-tools`

若已安装的命令缺少某个选项，运行

agent-pulse <command> --help

并调整使用最接近的支持选项。

Workflow

工作流程

Start with
```
agent-pulse doctor --json
```
only when the user asks why data is missing, asks for setup help, or a normal data command returns no sessions.
Use JSON output whenever possible. Summarize the fields that matter: sessions, tokens, tools, search calls, model breakdown, source breakdown, estimated cost, warnings.
Use time filters for scoped questions. Default to 24 hours for "recent" and 168 hours for "this week":

powershell

agent-pulse status --json --hours 24
agent-pulse --json --hours 168 --limit 50

Use platform filters when the user asks about a specific agent system:

powershell

agent-pulse --json -P codex --hours 24
agent-pulse --json -P claude --hours 24
agent-pulse top --json -P aider --sort cost
agent-pulse status --json -P cursor

For cost questions, pair summary, model, and top-session views:

powershell

agent-pulse status --json --hours 24
agent-pulse models --json --hours 24
agent-pulse top --sort cost --json --hours 24
agent-pulse optimize --json --hours 168

For trend and risk questions, use forecast/history/compare/anomaly:

powershell

agent-pulse forecast --json
agent-pulse history --json
agent-pulse compare --json
agent-pulse anomaly --json

For setup, use the discovery commands before guessing paths:

powershell

agent-pulse doctor --json
agent-pulse scan --json --details
agent-pulse config show

仅当用户询问数据缺失原因、设置帮助，或常规数据命令未返回会话时，才先运行
```
agent-pulse doctor --json
```
。
尽可能使用JSON输出。汇总关键字段：会话、令牌、工具、搜索调用、模型细分、源平台细分、估算成本、警告信息。
针对限定范围的问题使用时间过滤器。“近期”默认设为24小时，“本周”默认设为168小时：

powershell

agent-pulse status --json --hours 24
agent-pulse --json --hours 168 --limit 50

当用户询问特定agent系统时，使用平台过滤器：

powershell

agent-pulse --json -P codex --hours 24
agent-pulse --json -P claude --hours 24
agent-pulse top --json -P aider --sort cost
agent-pulse status --json -P cursor

针对成本相关问题，结合汇总、模型和热门会话视图：

powershell

agent-pulse status --json --hours 24
agent-pulse models --json --hours 24
agent-pulse top --sort cost --json --hours 24
agent-pulse optimize --json --hours 168

针对趋势和风险相关问题，使用预测/历史/对比/异常检测命令：

powershell

agent-pulse forecast --json
agent-pulse history --json
agent-pulse compare --json
agent-pulse anomaly --json

针对设置问题，先使用发现命令再猜测路径：

powershell

agent-pulse doctor --json
agent-pulse scan --json --details
agent-pulse config show

Interpreting Results

结果解读

Treat
```
total_cost_usd
```
as an estimate based on Agent Pulse's local model pricing table.
Report both cost and token volume; low-cost models can still have very high token usage.

Distinguish sources such as

codex

claude

hermes

deepseek

openclaw

aider

cursor

opencode

, and

goose

Mention if
```
doctor
```
reports missing optional sources, missing
```
dev_root
```
, or optional web dependencies.
If no sessions appear, check
```
doctor
```
, then try a wider time window such as
```
--hours 168
```
.
Check whether the user asked for a source (
```
-P
```
) filter, a model filter, or a project comparison before giving overall totals.
If a command emits plain text instead of JSON or fails because an installed version is older, run
```
agent-pulse <command> --help
```
and use the closest supported option.

将
```
total_cost_usd
```
视为基于Agent Pulse本地模型定价表的估算值。
同时报告成本和令牌用量；低成本模型仍可能有极高的令牌消耗。

区分

codex

、

claude

、

hermes

、

deepseek

、

openclaw

、

aider

、

cursor

、

opencode

和

goose

等源平台。

若
```
doctor
```
报告缺失可选源平台、缺失
```
dev_root
```
或可选Web依赖，请提及这些信息。
若未显示任何会话，先检查
```
doctor
```
结果，再尝试扩大时间范围，例如
```
--hours 168
```
。
在给出总统计数据前，确认用户是否要求了源平台(
```
-P
```
)过滤、模型过滤或项目对比。
若命令输出纯文本而非JSON，或因安装版本过旧导致运行失败，运行
```
agent-pulse <command> --help
```
并使用最接近的支持选项。

Reports

报告

For a short human-readable answer, run JSON commands and summarize.

For artifacts, prefer:

powershell

agent-pulse report --period daily
agent-pulse export -f markdown
agent-pulse export-html

Do not invent exact savings or costs. Use the CLI output.

若需要简短的易读答案，运行JSON命令并汇总结果。

若需要生成文件，优先使用：

powershell

agent-pulse report --period daily
agent-pulse export -f markdown
agent-pulse export-html

不要编造精确的节省金额或成本数据，以CLI输出为准。

Integrations

集成

Use the web and API extras only when the user asks for a browser dashboard or programmatic server. Ask before installing missing extras:

powershell

pip install "agentpulse-cli[web]"
agent-pulse web --port 8765
agent-pulse api --port 8766

For monitoring pipelines:

powershell

agent-pulse metrics --format prometheus
agent-pulse health --cost-limit 100 --token-limit 1000000 --json

仅当用户要求浏览器仪表盘或程序化服务器时，才使用Web和API扩展功能。安装缺失的扩展前请先询问用户：

powershell

pip install "agentpulse-cli[web]"
agent-pulse web --port 8765
agent-pulse api --port 8766

针对监控流水线：

powershell

agent-pulse metrics --format prometheus
agent-pulse health --cost-limit 100 --token-limit 1000000 --json

MCP

MCP集成

Use MCP mode when the user wants other AI clients to query Agent Pulse:

powershell

agent-pulse mcp --list-tools
agent-pulse mcp

When explaining MCP, mention that it exposes tools such as status, forecast, top sessions, model analytics, optimization, health, search, and leaderboard.

当用户希望其他AI客户端查询Agent Pulse时，使用MCP模式：

powershell

agent-pulse mcp --list-tools
agent-pulse mcp

解释MCP时，需说明它暴露了状态、预测、热门会话、模型分析、优化、健康检查、搜索和排行榜等工具。

Local Helper

本地辅助工具

This skill includes

scripts/run_agent_pulse_snapshot.py

, which runs a compact set of JSON-friendly Agent Pulse checks and prints a combined summary:

powershell

python scripts/run_agent_pulse_snapshot.py --hours 24 --days 7

本技能包含

scripts/run_agent_pulse_snapshot.py

，它会运行一组精简的、支持JSON的Agent Pulse检查，并打印合并后的汇总信息：

powershell

python scripts/run_agent_pulse_snapshot.py --hours 24 --days 7