Command-Line Interface

casen

Manage Camunda 8 clusters from your terminal. Deploy processes, resolve incidents, query instances, and generate connector templates — all with one tool.

$ npm install -g @bpmnkit/cli

Profile setup → process list → deploy → incidents → JSON output

What it does

Everything you need
for Camunda 8 ops

Interactive TUI

Navigate menus, commands, and input forms with arrow keys. Run casen with no arguments to enter the full TUI.

Connection Profiles

Store multiple clusters — dev, staging, prod. Switch with --profile or casen profile use. Supports Bearer, OAuth2, and Basic auth.

Full API Coverage

Processes, instances, incidents, jobs, decisions, variables, messages, and signals — all 34 resource groups, 180+ operations.

Connector Generation

Point casen connector generate at an OpenAPI or Swagger spec and get ready-to-use Camunda element templates.

Flexible Output

Human-readable tables by default. Add --json for machine-readable output. Pipe straight into jq or scripts.

Shell Completion

Tab completion for bash, zsh, and fish. One command to install. Never mistype a subcommand again.

Reference

Commands

Profile
casen profile listList all saved profiles
casen profile add <name>Add a profile interactively
casen profile use <name>Switch the active profile
casen profile remove <name>Delete a profile
Processes
casen processes listList deployed process definitions
casen instances listList process instances
casen instances cancel <key>Cancel a running instance
casen deploy <file>Deploy a BPMN, DMN, or form file
Incidents & Jobs
casen incidents listList open incidents
casen incidents resolve <key>Resolve an incident
casen jobs listList active jobs
Decisions & Variables
casen decisions listList deployed decision definitions
casen variables list <key>List variables for a process instance
casen messages publishPublish a message correlation
Connector
casen connector generate <spec>Generate element templates from OpenAPI/Swagger
Output

Human-readable
or machine-friendly

Table (default) casen processes list
  Name                  Version  Deployed
  ─────────────────────────────────────────────
  order-process         3        2026-03-15 09:42
  payment-gateway       1        2026-03-14 14:22
  notification-flow     2        2026-03-12 11:08

  3 process definitions
JSON --json
[
  {
    "key": 2251799813685229,
    "name": "order-process",
    "version": 3,
    "bpmnProcessId": "order-process"
  }
]
Flags

Global options

Flag Value Description
--profile <name> Use a specific saved connection profile for this command
--json Output results as JSON instead of a table
--help Show help for a command
Shell completion

Tab completion
for every shell

bash
# Add to ~/.bashrc
eval "$(casen completion bash)"
zsh
# Add to ~/.zshrc
eval "$(casen completion zsh)"
fish
# Add to fish config
casen completion fish \
  | source
Get started

Install in seconds

Available on npm. Works with npm, pnpm, bun, and yarn.

$ npm install -g @bpmnkit/cli
$ pnpm add -g @bpmnkit/cli
$ bun add -g @bpmnkit/cli
$ yarn global add @bpmnkit/cli

Then run casen to launch the interactive TUI, or casen --help to see all commands.