BPMN Kit

io.github.bpmnkitPublished by GitHub account bpmnkitv1.8.0Updated Nov 14, 2026

Create, validate, simulate and deploy Camunda 8 BPMN processes, forms and DMN from an agent.

Overview

AI-generated overview

Lets an assistant create, validate, simulate and deploy Camunda 8 BPMN processes, forms and DMN models through the local casen CLI.

What you can do
  • Create and edit BPMN, DMN and form files locally, with simulation, linting and test scenarios run on each change.
  • Deploy models and manage deployments, process definitions, instances, incidents and jobs on Camunda 8 clusters.
  • Browse the template gallery and write runnable process templates with their test scenarios and supporting files.
  • Generate connector templates from OpenAPI specs and apply them to elements in a BPMN file.
  • Generate TypeScript types for job workers and check them in CI, and convert Camunda 7 models to Camunda 8.
When to use it
Useful when an assistant should help design, test or ship Camunda 8 process automation, or migrate existing Camunda 7 models, rather than only discuss them. Also fits teams that want agent-driven deployment and monitoring of process instances on a cluster.
Requirements
Runs as a local process on the desktop via the npm package @bpmnkit/cli (Node.js required). A Camunda 8 cluster or local Reebe instance is needed for deployment and operations; SaaS access uses a profile with ZEEBE_CLIENT_ID and ZEEBE_CLIENT_SECRET, and ZEEBE_ADDRESS sets the REST address when no profile is active.
Before you install
Deploying, cancelling instances, resolving incidents and applying templates change state on a live Camunda cluster, so point it at a test environment first. The Camunda SaaS OAuth client secret (ZEEBE_CLIENT_SECRET) is a credential and should be stored in a profile rather than shared. Template use with the force option overwrites existing files.

Installation

In SourceWeft

  1. Open BPMN Kit in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Agents: run casen agent-card <bpmn|dmn|form> (~1k tokens) instead of reading this README.

[BPMN Kit logo]

@bpmnkit/cli

Command-line interface for Camunda 8 — deploy, manage, and monitor processes from the terminal

[npm] [license] [typescript] [ai-assisted] [tier: core]

Website · Documentation · GitHub · Changelog

Core tier. Semver at 1.0: nothing breaks without a major release. See product tiers.


Overview

@bpmnkit/cli provides the casen command-line tool for interacting with Camunda 8 clusters. Manage profiles, deploy processes, run queries, and generate connector templates — all from your terminal.

Installation

sh
npm install -g @bpmnkit/cli# orpnpm add -g @bpmnkit/cli

Quick Start

Develop locally — no cluster needed

sh
casen dev

Opens every .bpmn, .dmn and .form file in the folder in the BPMN Kit editor in your browser, with simulation. Saves go back to disk with the file's formatting kept, changes made elsewhere reload live, and each change re-runs lint and the file's .bpmn.tests.json scenarios. See casen dev.

Configure a profile

sh
# Camunda SaaS: the credentials file Hub offers for a cluster's API clientcasen profile import my-cluster ./camunda-credentials.shcasen profile use my-cluster

Deploy a process

sh
casen deploy deploy order-process.bpmn --target camunda8

List process instances

sh
casen pi list --filter '{"state":"ACTIVE"}'

Commands

Profile management

CommandDescription
casen profile listList all configured profiles
casen profile create <name>Add a profile from flags (--base-url, --auth-type, …)
casen profile import <name> <file>Add a profile from a Camunda credentials file
casen profile use <name>Switch the active profile
casen profile delete <name>Delete a profile

Process & deployment

CommandDescription
casen deploy deploy <file> [--target camunda8]Deploy a BPMN, DMN, or form file to local Reebe or the active profile
casen resource create-deployment <file...>Deploy several files as one deployment to the active profile
casen pd listList deployed process definitions
casen pi list [--filter <json>]List process instances
casen pi cancel <key>Cancel a running instance

Templates

CommandDescription
casen template list [--category <c>]List the runnable process templates from the gallery
casen template use <id> [dir]Write a template's .bpmn, .bpmn.tests.json scenarios and any .dmn/.form files (--force overwrites)

Incidents & jobs

CommandDescription
casen incident listList incidents
casen incident resolve <key>Resolve an incident
casen job listList jobs

Connector generation

CommandDescription
casen connector generate <spec>Generate element templates from OpenAPI/Swagger
casen connector show <template> [--filter <text>] [--condensed]List a template's property keys, types and defaults
casen connector apply <file.bpmn> <elementId> <template>Apply a template from --values file.json and --set key=value

Typed code generation

CommandDescription
casen gen types <files...> --out <file>TypeScript types for job workers (job types, variables, headers, messages, error codes)
casen gen types <files...> --out <file> --checkExit 1 when the generated file is out of date (CI)
casen gen types <files...> --check-workers <glob> --strictReport job types without a worker and workers without a job type

Camunda 7 migration

CommandDescription
casen migrate c7 <files...>Convert Camunda 7 models to Camunda 8 (<name>.c8.bpmn, or --out <dir>) and report each construct as convertible, manual or unsupported
casen migrate c7 <files...> --checkReport only; exit 1 while manual or unsupported findings remain (--format json for CI)

See Migrate from Camunda 7 for what is converted and why.

Global options

FlagDescription
--profile <name>Use a specific profile for this command
--jsonOutput as JSON (machine-readable)
--helpShow help

Related Packages

PackageDescription
@bpmnkit/coreBPMN/DMN/Form parser, builder, layout engine
@bpmnkit/canvasZero-dependency SVG BPMN viewer
@bpmnkit/editorFull-featured interactive BPMN editor
@bpmnkit/engineLightweight BPMN process simulator for tests and demos
@bpmnkit/feelFEEL expression language parser & evaluator
@bpmnkit/plugins34 composable canvas plugins
@bpmnkit/apiCamunda 8 REST API TypeScript client
@bpmnkit/asciiRender BPMN diagrams as Unicode ASCII art
@bpmnkit/markdownBPMN diagrams in Markdown — remark, markdown-it and README pre-rendering
@bpmnkit/viewer-lite8.5 KB BPMN viewer for one self-contained HTML file
@bpmnkit/docspackBPMN Kit docs as an offline docspack package for AI agents
@bpmnkit/camunda-docspackCamunda 8 docs as an offline docspack package for AI agents
@bpmnkit/uiShared design tokens and UI components
@bpmnkit/profilesShared auth, profile storage, and client factories for CLI & proxy
@bpmnkit/operateMonitoring & operations frontend for Camunda clusters
@bpmnkit/connector-genGenerate connector templates from OpenAPI specs
@bpmnkit/connectorsCamunda 8 OOTB connector catalog and deterministic template application
@bpmnkit/proxyLocal AI bridge and Camunda API proxy server
@bpmnkit/patternsDomain process patterns for BPMNKit AIKit
@bpmnkit/reebe-wasmWebAssembly BPMN engine for browser simulation
@bpmnkit/worker-clientThin Zeebe REST client for standalone workers
@bpmnkit/flowCode-first durable flows that derive BPMN, job types and workers
@bpmnkit/user-tasksEmbeddable user task widget for Camunda 8
@bpmnkit/cli-sdkPlugin authoring SDK for the casen CLI
@bpmnkit/create-casen-pluginScaffold a new casen CLI plugin in seconds
@bpmnkit/casen-reportHTML reports from Camunda 8 incident and SLA data
@bpmnkit/casen-worker-httpExample HTTP worker plugin — completes jobs with live JSONPlaceholder API data
@bpmnkit/casen-worker-aiAI task worker — classify, summarize, extract, and decide using Claude

License

MIT © BPMN Kit — made by u11g

Source: apps/cli/README.md at commit e4a2e9b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

8
  1. v1.8.0LatestNov 14, 2026
  2. v1.7.0Nov 11, 2026
  3. v1.5.0Nov 7, 2026
  4. v1.4.0Oct 20, 2026
  5. v1.3.1Oct 8, 2026
  6. v1.3.0Oct 6, 2026
  7. v1.2.0Oct 1, 2026
  8. v1.1.0Sep 29, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts