Pulse
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.
Why
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-run
and 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.
Get started
| 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.
What's in this repository
Documentation
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.
Development
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 change
Details: developer guide; the rules for code changes are in CLAUDE.md.
Releases
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.
Contributing
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.
License
MIT © Miragon GmbH
