Позволяет AI-клиенту наблюдать за сессиями Claude Code и Codex CLI, искать их, запускать и управлять ими через панель управления собственным парком агентов.
Также известен как jstuart0/agentpulse, @craze0/agentpulse-mcp
- Звёзды
- 34
- Инструменты
- —
- Загрузки, 30 дней
- 692
- Последняя версия
- —
- Последний коммит
- 11 нояб. 2026 г.
- Лицензия
- MIT
Что такое AgentPulse MCP?
Позволяет AI-клиенту наблюдать за сессиями Claude Code и Codex CLI, искать их, запускать и управлять ими через панель управления собственным парком агентов.
Сводка сгенерирована из README проекта
О AgentPulse MCP server
AgentPulse позволяет разработчикам, использующим Claude Code, Codex CLI, Copilot CLI или OpenCode, отслеживать и управлять множеством AI-сессий кодинга из единой панели управления. Он предоставляет централизованный интерфейс для наблюдения за активными агентами на разных машинах, отображая их текущий статус, контекст проекта и полную историю чатов с промптами и использованием инструментов.
Пользователи могут выбирать между режимом наблюдения (observability mode) для отслеживания сессий в реальном времени или режимом оркестрации (orchestration mode) для запуска, управления и контроля сессий через локального супервизора. Система поддерживает self-hosting через Docker или Kubernetes с базами данных SQLite или PostgreSQL. Она позволяет удаленно управлять сессиями, давая возможность отправлять промпты, останавливать или перезапускать задачи с другого компьютера.
Используя предоставленный MCP server, вы можете даже позволить одному агенту управлять всем вашим парком. Это позволяет основному агенту напрямую выводить списки, искать, запускать и управлять другими сессиями. Платформа организует работу по проектам и использует шаблоны сессий для автоматизации настройки конфигураций агентов и маршрутизации хостов.
Что вы можете с ним делать
- 1Мониторинг множества активных сессий кодингаПросматривайте сетку всех запущенных сессий Claude Code и Codex CLI в реальном времени, чтобы видеть, какие из них работают, ожидают или простаивают.
- 2Управление агентами с удаленного устройстваУправляйте своими кодинг-агентами с телефона или другого компьютера, удаленно запуская или останавливая сессии.
- 3Автоматизация управления агентами через MCPПозвольте основному AI-агенту оркестровать весь ваш парк сессий кодинга с помощью MCP server.
- 4Централизация активности агентов на разных машинахСобирайте данные сессий с различных ноутбуков, десктопов или серверов в единую панель управления.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить AgentPulse MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка AgentPulse MCP в Claude Code
$ claude mcp add agentpulse -- npx -y @craze0/agentpulse-mcpУстановка AgentPulse MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agentpulse": {
"command": "npx",
"args": [
"-y",
"@craze0/agentpulse-mcp"
]
}
}
}Установка AgentPulse MCP в VS Code
.vscode/mcp.json
{
"servers": {
"agentpulse": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@craze0/agentpulse-mcp"
]
}
}
}Установка AgentPulse MCP в VS Code CLI
$ code --add-mcp '{"name":"agentpulse","type":"stdio","command":"npx","args":["-y","@craze0/agentpulse-mcp"]}'Установка AgentPulse MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agentpulse": {
"command": "npx",
"args": [
"-y",
"@craze0/agentpulse-mcp"
]
}
}
}Установка AgentPulse MCP в Codex
$ codex mcp add agentpulse -- npx -y @craze0/agentpulse-mcpУстановка AgentPulse MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.agentpulse] command = "npx" args = ["-y", "@craze0/agentpulse-mcp"]
Установка AgentPulse MCP в Gemini CLI
$ gemini mcp add -s user agentpulse npx -- -y @craze0/agentpulse-mcpУстановка AgentPulse MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agentpulse": {
"command": "npx",
"args": [
"-y",
"@craze0/agentpulse-mcp"
]
}
}
}Конфигурация
AGENTPULSE_AI_ENABLEDAGENTPULSE_OTEL_ENDPOINTAGENTPULSE_SECRETS_KEYAPI_TOKENTELEGRAM_BOT_TOKENTELEGRAM_WEBHOOK_SECRET
| Название | Описание | Тип |
|---|---|---|
| AGENTPULSE_AI_ENABLED | — | |
| AGENTPULSE_OTEL_ENDPOINT | — | |
| AGENTPULSE_SECRETS_KEY | — | |
| API_TOKEN | — | |
| TELEGRAM_BOT_TOKEN | — | |
| TELEGRAM_WEBHOOK_SECRET | — |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыНе проверялось
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
README
Открыть на GitHubAgentPulse
Open-source, self-hosted dashboard to monitor, orchestrate and remotely control Claude Code and Codex CLI sessions, and observe Copilot CLI and OpenCode, across all your machines.
If you run multiple Claude Code, Codex CLI, Copilot CLI, or OpenCode sessions across different terminal tabs, you know the pain: which tab is doing what? AgentPulse gives you a live dashboard that shows every active session, what it's working on, and a scrollable chat history of everything you've said to each agent.

The AgentPulse dashboard: every running Claude Code, Codex CLI, Copilot CLI and OpenCode session in one grid, marked Working, Waiting, Idle or Error.
What AgentPulse is
AgentPulse has two major modes:
- Observability -- watch Claude Code, Codex, Copilot CLI, and OpenCode sessions in real time, with prompts, responses, progress, notes, and session history in one dashboard (Copilot CLI and OpenCode are observed only -- AgentPulse can't launch or steer them)
- Orchestration -- launch and manage sessions from AgentPulse itself with templates, supervisors, headless tasks, interactive sessions, retries, host routing, answering a managed Codex session's command and file-change approvals from the dashboard (see Answering Codex approvals), and continuing a Claude Code session you started by hand as a fork, with its approvals answered the same way (see Continuing a Claude Code session)
Plus an AI Labs layer that's very new and explicitly experimental -- see the Labs section below.
You can run AgentPulse as:
- observability only -- hooks + dashboard, no supervisor/control plane
- full local orchestration -- hooks + dashboard + local supervisor for launch/control on the same machine
- remote dashboard -- relay local events to a remote AgentPulse instance
Use cases
- Monitor multiple Claude Code sessions at once. One live grid instead of a dozen terminal tabs, with each session's state, last prompt and full history. Guide
- See agents on every machine in one place. A relay on each laptop, desktop or server forwards events to one dashboard, with a filter by machine. Guide
- Check on and control Claude Code from your phone or another computer. Watch any session remotely, and launch, prompt, stop or retry the ones AgentPulse started. Guide
- Self-host it for yourself or a team. Docker or Kubernetes, SQLite or PostgreSQL, behind Authentik, Authelia, oauth2-proxy, Pomerium or Cloudflare Access. Guide
- Let your agents manage your other agents over MCP. Claude Code or Codex CLI can list, search, launch and steer sessions through the
@craze0/agentpulse-mcpserver. Guide
Not sure whether you need monitoring or orchestration? See observability vs. orchestration for AI coding agents.
How it works
Your terminal tabs AgentPulse dashboard
┌─────────────────┐ ┌──────────────────────┐
│ Claude Code (1) │──── hook events ──────>│ bold-falcon: active │
│ fixing auth bug │ │ "fix the auth bug" │
├─────────────────┤ ├──────────────────────┤
│ Claude Code (2) │──── hook events ──────>│ zen-owl: active │
│ writing tests │ │ "add unit tests" │
├─────────────────┤ ├──────────────────────┤
│ Codex CLI │──── hook events ──────>│ warm-crane: idle │
│ (idle) │ │ last: 5m ago │
├─────────────────┤ ├──────────────────────┤
│ Copilot CLI │──── hook events ──────>│ quiet-otter: active │
│ (observed only) │ │ "review the diff" │
├─────────────────┤ ├──────────────────────┤
│ OpenCode │──── plugin events ────>│ calm-heron: idle │
│ (observed only) │ │ last: 2m ago │
└─────────────────┘ └──────────────────────┘
Each session gets a random memorable name (like bold-falcon) so you can match the dashboard to your terminal tabs at a glance. Click any session to see a live chat-style timeline of your prompts and the agent's tool usage.
Quick start
Easiest local install: 1 command
macOS / Linux:
This installs AgentPulse locally with Bun + SQLite, starts the web app and local supervisor as services, and configures Claude Code + Codex hooks automatically.
curl -fsSL https://raw.githubusercontent.com/jstuart0/agentpulse/main/scripts/install-local.sh | bash
Windows:
irm https://raw.githubusercontent.com/jstuart0/agentpulse/main/scripts/install-local.ps1 | iex
It needs curl and git, plus python3 for the supervisor and hooks. If it can't find a Bun 1.3.12 or newer it installs a pinned one, which also needs unzip and shasum or sha256sum. Anything missing is listed up front with the command to install it, and nothing is installed until it's there. To put Bun somewhere of your choosing (supply it again on a re-run; with a BUN_INSTALL other than ~/.bun, only $BUN_INSTALL/bin/bun is considered, not PATH):
curl -fsSL https://raw.githubusercontent.com/jstuart0/agentpulse/main/scripts/install-local.sh | BUN_INSTALL=/opt/bun bash
When it finishes, open http://localhost:3000 and start a new Claude Code or Codex session.
Docker install: 1 shell line
If you prefer Docker, this starts the container, waits for health, and configures hooks:
docker run -d -p 127.0.0.1:3000:3000 -v agentpulse-data:/app/data -e DISABLE_AUTH=true --restart unless-stopped --name agentpulse ghcr.io/jstuart0/agentpulse && until curl -fsSL http://localhost:3000/api/v1/health >/dev/null 2>&1; do sleep 1; done && curl -fsSL http://localhost:3000/setup.sh | bash
Security note:
-p 127.0.0.1:3000:3000binds the host port to localhost only. The older-p 3000:3000form would publish on all host interfaces, exposing the auth-disabled server to your LAN. Use the127.0.0.1:prefix wheneverDISABLE_AUTH=true.
Done. Open http://localhost:3000 and you have:
- live session observability
- local launch/control via the supervisor
- Claude Code + Codex hooks already configured
Why localhost? Claude Code and Codex block HTTP hooks to remote/private IPs as a security measure. Only
localhost/127.0.0.1is allowed. This keeps things simple -- one Docker container on your machine, no networking to configure. If port 3000 is taken, use any free port:docker run -d -p 127.0.0.1:4000:3000 -v agentpulse-data:/app/data -e DISABLE_AUTH=true -e PUBLIC_URL=http://localhost:4000 --restart unless-stopped --name agentpulse ghcr.io/jstuart0/agentpulse curl -fsSL http://localhost:4000/setup.sh | bash
What you'll see

Session detail: a chat-style history of your prompts to one agent, with its tool calls inline.
- Dashboard -- grid of all sessions with status, project name, session name, duration, and tool use count. Each session is in exactly one operational state: Waiting (the agent finished a turn, or has an outstanding permission prompt, and is waiting on you -- "Mark as seen" clears it), Error (the session failed and hasn't been dismissed -- "Dismiss error" clears it), Working (the agent is actively working right now), or Idle (nothing is waiting and the agent isn't working). Status cards above the grid filter by state; a "What do these states mean?" popover repeats this explanation in the UI
- Session detail -- click a session to see a chat-style timeline with your prompts as blue bubbles and tool usage inline
- Unsent prompts -- a prompt you typed in a session's box and haven't sent is kept in your browser (in plain text, in
localStorage) for up to 7 days, per person and per session, so it survives switching sessions and reloading. It says "Unsent draft, saved ..." with a Discard draft button (and an Undo for a few seconds), drafts over 20,000 characters are kept only while the page is open, and Sign out removes every draft this browser holds - Projects -- first-class projects with cwd-based session resolution; sessions stamp themselves with the right project on ingest, templates inherit project defaults (cwd, agentType, model) with per-field overrides, and a
/projectspage lets you create / edit / delete them. Saving a template under a new directory auto-creates the project for you - Session templates -- save reusable Claude Code and Codex session setups, link them to a project for live-inheritance defaults, preview normalized launch specs, and route launches to the right host
- Orchestration -- launch headless or interactive sessions from AgentPulse, track launch status, retry, stop, and manage sessions through the local supervisor
- Search -- full-text across session names, prompts, plans, notes, and event payloads. SQLite uses FTS5 (BM25-ranked); Postgres uses ILIKE. Clicking an event hit jumps to the matching event in the timeline and applies a brief amber flash
- Inbox -- single
/inboxview that aggregates every open approval (HITL, Ask-driven actions, alert-rule firings), stuck / risky session warnings, and recent failures. Approve / decline inline; snooze noisy items - Real-time updates -- everything updates live via WebSocket, no refreshing needed
- Random session names -- each session gets a name like
brave-falconso you can tell them apart - CLAUDE.md editor -- view and edit your agent instruction files from the dashboard
- Setup page -- generates hook config you can copy-paste, or use the one-liner above
- MCP server -- let Claude Code, Codex CLI, or any MCP-compliant agent observe and orchestrate your fleet directly (list/inspect sessions, search, launch agents, steer live sessions, decide inbox items). Ships from a checkout via
agentpulse mcp serve, or standalone via the@craze0/agentpulse-mcpnpm package -- no checkout required. See below. - AI Labs (experimental) -- optional AI layer that watches sessions, classifies health, proposes next steps with human-in-the-loop approval, plus an Ask command surface that lets you launch / edit / search / summarize / alert in natural language. Each feature is behind its own Labs toggle. See below.
MCP server
AgentPulse can be driven by an external AI coding agent over the Model Context Protocol: read tools (sessions, search, digest, AI intelligence) plus orchestration tools (launch agents, prompt/stop live sessions, decide HITL/inbox items), gated behind a scoped API key.
From a checkout:
agentpulse mcp install --mint my-agent # observe-only (read-only), the safe default
agentpulse mcp install --mint my-agent --orchestrate # adds launch/steer/decide -- read the security notes first
Without cloning this repo -- the standalone @craze0/agentpulse-mcp npm package:
npx @craze0/agentpulse-mcp install --mint my-agent
Either way, install prints ready-to-paste Claude Code and Codex CLI config. See docs/MCP.md for the full tool catalog, client setup, and a security section covering what a manage-scoped key can do and why Codex CLI does not honor Claude Code's confirmation prompt.
AI Labs (experimental)

The Ask assistant: ask about, launch or search your agent sessions in plain language.
Heads up: the AI layer is new, shipping under explicit Labs framing. Every feature is toggleable under Settings → Labs. Contracts, UI, and defaults may change. Disable any toggle if it gets in your way -- nothing else in AgentPulse depends on it.
When enabled, AgentPulse can use an LLM provider you choose (Anthropic, OpenAI, OpenRouter, Google, or any OpenAI-compatible endpoint like Ollama / LM Studio / vLLM) to do the following. All AI work is human-in-the-loop by default: the watcher proposes, you approve or decline, and the runtime records every step as an auditable event.
Вопросы о AgentPulse MCP
Как добавить AgentPulse MCP в Claude Code?
Выполните claude mcp add agentpulse -- npx -y @craze0/agentpulse-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить AgentPulse MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Что может делать AI-агент с помощью MCP server AgentPulse?
Через MCP server он может выводить списки и инспектировать сессии, искать по истории, запускать новые сессии агентов, управлять активными сессиями и обрабатывать входящие задачи.
Как установить MCP server AgentPulse без клонирования репозитория?
Используйте автономный npm пакет @craze0/agentpulse-mcp; альтернативный вариант — команда agentpulse mcp serve.
Какие кодинг-агенты поддерживаются в AgentPulse?
Поддерживаются Claude Code, Codex CLI, GitHub Copilot CLI и OpenCode, однако Copilot CLI и OpenCode доступны только в режиме наблюдения.
Можно ли развернуть AgentPulse на собственных мощностях?
Да, его можно развернуть самостоятельно через Docker или Kubernetes с использованием SQLite или PostgreSQL, по желанию — за прокси-сервером аутентификации.
Отображает ли AgentPulse обновления в реальном времени?
Да, сессии и события обновляются в реальном времени через WebSocket без перезагрузки страницы.