Agent Inventory | Agent 清单

Scan, track, and visualize AI agents running on your machine. 扫描、追踪并可视化你电脑上运行的 AI Agent。

What is this? | 这是什么

EN: AI coding tools are multiplying fast — Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Cursor, Copilot... They're all Agent-like processes running on your machine, but there's no simple way to see what's running right now.

Agent Inventory is a CLI tool + Web dashboard that gives you a single pane of glass for every AI agent on your system.

中文： AI 编程工具越来越多——Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Cursor、Copilot……它们本质上都是在你电脑上运行的 Agent 进程，但一直没有一个简单的方法能看看当前到底跑了哪些。

Agent Inventory 是一个 CLI 工具 + Web 仪表盘，让你一眼看清系统上所有 AI Agent。

Quick Start | 快速开始

# Install | 安装
npm install -g agent-inventory

# Scan for AI agents | 扫描AI Agent
agent-inventory scan

# View inventory | 查看清单
agent-inventory list

# Launch web dashboard | 启动Web仪表盘
agent-inventory dashboard

Commands | 命令

| Command | EN Description | 中文说明 | |---------|---------------|---------| | scan | Scan running processes for AI agents | 扫描运行中的AI Agent进程 | | list | List all tracked agents | 列出所有已追踪的Agent | | mcp | Detect running MCP servers | 检测本地MCP服务器 | | dashboard | Start the web dashboard | 启动Web仪表盘 | | status | Quick overview | 快速概览统计 |

Options | 选项

| Flag | Applies to | EN Description | 中文说明 | |------|-----------|---------------|---------| | --lang <lang> | all | Set language: en or zh | 设置语言：en 或 zh | | --json / -j | scan, list, mcp | Output raw JSON | 输出原始JSON | | --all / -a | list | Include offline agents | 包含离线Agent | | --type <type> | list | Filter by type | 按类型筛选 | | --detect-mcp | scan | Also detect MCP servers | 同时检测MCP服务器 | | --port <port> | dashboard | Web dashboard port (default 3000) | Web端口（默认3000） |

Tip: Set language with --lang zh for Chinese output, or set environment variable LANG=zh. 提示： 使用 --lang zh 切换中文输出，或设置环境变量 LANG=zh。

Agent Types Detected | 可识别的Agent类型

| Type | EN Examples | 中文示例 | |------|-------------|---------| | ai-coding-cli | Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw | 命令行AI编程工具 | | ai-coding-ide | Cursor, Copilot, Continue | IDE AI插件 | | ai-chat | ChatGPT, Claude Desktop | AI聊天应用 | | mcp-server | Any process with "mcp" in name | 含"MCP"的进程 |

Dashboard | 仪表盘

EN: The web dashboard provides:

• Real-time agent status (online / offline)
• Search & filter by name or type
• Agent details: PID, command, first / last seen
• Auto-refresh every 30 seconds
• Language toggle (top right corner)

中文： Web 仪表盘提供：

• 实时 Agent 状态（在线 / 离线）
• 按名称或类型搜索过滤
• Agent 详情：PID、启动命令、首次/最后发现时间
• 每30秒自动刷新
• 右上角语言切换按钮

agent-inventory dashboard
# Open | 打开 http://localhost:3000

How it works | 工作原理

EN:

1. scan runs tasklist (Windows) or ps aux (macOS/Linux)
2. Matches processes against known AI agent patterns
3. Merges results into a persistent JSON inventory at ~/.agent-inventory/inventory.json
4. Tracks agent state across scans — agents that disappear go "offline" automatically

中文：

1. scan 执行 tasklist（Windows）或 ps aux（macOS/Linux）
2. 将进程与已知的AI Agent模式匹配
3. 结果合并到 ~/.agent-inventory/inventory.json 持久化存储
4. 跨扫描追踪Agent状态——消失的Agent自动标记为"离线"

Data Location | 数据位置

EN: All data is stored locally at ~/.agent-inventory/inventory.json. No telemetry, no phoning home.

中文： 所有数据存储在本地 ~/.agent-inventory/inventory.json。不上传，不收集，不联网。

Roadmap | 开发计划

• [x] Basic scan & inventory | 基础扫描与清单
• [x] Web dashboard | Web 仪表盘
• [x] Bilingual (EN/ZH) | 中英文双语支持
• [x] MCP server connection detection | MCP服务器连接检测
• [ ] Manual agent registration | 手动注册Agent
• [ ] Token/resource usage estimates | Token/资源消耗估算
• [ ] Historical trends | 历史趋势图

License | 开源协议

MIT