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

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

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