Pulse brings your Camunda 7, CIB seven and Operaton engines to where you already work. One idea, three clients on the same engines:
- Your AI chat: an MCP server that answers with interactive views of incidents, instances and diagrams, in Claude, ChatGPT and other hosts.
- Your terminal:
pulse-cli, every engine operation as one short command, for people and AI agents alike. - VS Code: runtime data next to your BPMN models: instances, incidents, variables and retries.
Pulse is part of Miragon AI, the family of Miragon's AI tools.
Finding out why a process instance is stuck usually means a cockpit, a few REST calls and a log. Pulse brings the engine to you instead:
- One question, one answer. Ask why an order is stuck and get the incident, the diagram and the root cause, in the chat, in one command or next to the model.
- Every engine of your fleet. CIB seven, Operaton and Camunda 7 side by side, with a default engine and an override per call.
- Safe by default. The MCP server starts read-only, the CLI previews a change with
--dry-runand asks before it deletes, and VS Code writes only to a local engine unless you allow more. - Analytics without the engine database. Process KPIs, bottlenecks and engine comparisons come from Prometheus, fed by a small metrics plugin in the engine.
- Self-hosted and open. One container image, public npm packages, MIT licensed.
| Client | Install | Read on |
|---|---|---|
| Your AI chat | docker run ghcr.io/miragon/pulse-server, or try the public playground |
Server README, docs |
| Your terminal | npm install -g @miragon/pulse-cli or brew install miragon/tap/pulse-cli |
CLI README, docs |
| VS Code | Pulse from the Marketplace or Open VSX (early prototype) | Extension README, docs |
No engine at hand? Connect your Claude to the public playground, or
start one locally with docker run -p 8080:8080 operaton/operaton:2.1.5.
| Path | Package | Role |
|---|---|---|
apps/mcp-server-camunda7/ |
ghcr.io/miragon/pulse-server |
The MCP server: composes the modules, serves HTTP on :8400 |
apps/cli/ |
@miragon/pulse-cli |
The command line interface |
apps/vscode/ |
pulse (a .vsix) |
Pulse for VS Code |
packages/connectors/camunda/camunda7-connector/ |
@miragon/pulse-camunda7-connector |
Operations tools and widgets for Camunda 7 engines |
packages/connectors/analytics/analytics-connector/ |
@miragon/pulse-analytics-connector |
Prometheus-backed analytics tools and dashboards |
packages/connectors/camunda/camunda7-client/ |
@miragon/pulse-camunda7-client |
Typed REST SDK for the engine, with Zod input schemas |
packages/connectors/analytics/analytics-client/ |
@miragon/pulse-analytics-client |
Prometheus client, PromQL queries and the metrics contract |
packages/core/widget-shell/ |
@miragon/pulse-widget-shell |
Shared widget kit and server boot for composed MCP servers |
engine-plugins/ |
io.miragon.mcp:cibseven-history-metrics |
Micrometer metrics plugin for the engine (Java 21) |
playground/ |
— | Demo engine, Compose stack and the public playground |
templates/composed-server/ |
Miragon/pulse-starter |
Starter for your own server with your own connector |
The docs site, miragon.github.io/pulse, is built from docs/,
one section per client:
- MCP server: getting started, usage, every tool, operations, architecture
- CLI: install, commands, configuration, authentication, AI agents
- VS Code: installation, configuration, usage, architecture
The product page is miragon.ai/tools/pulse.
pnpm install --frozen-lockfile
docker compose -f playground/docker/docker-compose.yml up -d # CIB seven, OTEL, Prometheus, Grafana
cp .env.example .env
pnpm dev # MCP server on :8400, inspector at /mcp/inspector
pnpm build && pnpm typecheck && pnpm test && pnpm lint # the bar for every changeDetails: developer guide; the rules for code changes are in CLAUDE.md.
release-please releases everything together:
semantic commits on main open a release PR, and merging it publishes the server image, the npm
packages, the CLI (npm, binaries, image, Homebrew miragon/tap/pulse-cli), the VS Code extension
(Marketplace and Open VSX) and the engine plugin (Maven Central). Up to 0.20.0 the server and its
packages shipped as "Miragon AI"; the rename note
maps each old name to its new one.
Issues, pull requests and discussions are welcome on GitHub.
Use semantic commit messages (they drive the release) and
keep pnpm build && pnpm typecheck && pnpm test && pnpm lint green.
MIT © Miragon GmbH