Website · Documentation · GitHub · Changelog

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

npm install -g @bpmnkit/cli
# or
pnpm add -g @bpmnkit/cli

Quick Start

Configure a profile

casen profile add my-cluster
# Interactive prompts for base URL and auth type

Deploy a process

casen deploy order-process.bpmn

List process instances

casen instances list --state active

Commands

Profile management

| Command | Description | |---------|-------------| | casen profile list | List all configured profiles | | casen profile add <name> | Add a new profile (interactive) | | casen profile use <name> | Switch the active profile | | casen profile remove <name> | Delete a profile |

Process & deployment

| Command | Description | |---------|-------------| | casen deploy <file> | Deploy a BPMN, DMN, or form file | | casen processes list | List deployed process definitions | | casen instances list | List process instances (--state filter) | | casen instances cancel <key> | Cancel a running instance |

Incidents & jobs

| Command | Description | |---------|-------------| | casen incidents list | List open incidents | | casen incidents resolve <key> | Resolve an incident | | casen jobs list | List active jobs |

Connector generation

| Command | Description | |---------|-------------| | casen connector generate <spec> | Generate element templates from OpenAPI/Swagger |

Global options

| Flag | Description | |------|-------------| | --profile <name> | Use a specific profile for this command | | --json | Output as JSON (machine-readable) | | --help | Show help |

Related Packages

| Package | Description | |---------|-------------| | @bpmnkit/core | BPMN/DMN/Form parser, builder, layout engine | | @bpmnkit/canvas | Zero-dependency SVG BPMN viewer | | @bpmnkit/editor | Full-featured interactive BPMN editor | | @bpmnkit/engine | Lightweight BPMN process execution engine | | @bpmnkit/feel | FEEL expression language parser & evaluator | | @bpmnkit/plugins | 22 composable canvas plugins | | @bpmnkit/api | Camunda 8 REST API TypeScript client | | @bpmnkit/ascii | Render BPMN diagrams as Unicode ASCII art | | @bpmnkit/ui | Shared design tokens and UI components | | @bpmnkit/profiles | Shared auth, profile storage, and client factories for CLI & proxy | | @bpmnkit/operate | Monitoring & operations frontend for Camunda clusters | | @bpmnkit/connector-gen | Generate connector templates from OpenAPI specs | | @bpmnkit/proxy | Local AI bridge and Camunda API proxy server | | @bpmnkit/cli-sdk | Plugin authoring SDK for the casen CLI | | @bpmnkit/create-casen-plugin | Scaffold a new casen CLI plugin in seconds | | @bpmnkit/casen-report | HTML reports from Camunda 8 incident and SLA data | | @bpmnkit/casen-worker-http | Example HTTP worker plugin — completes jobs with live JSONPlaceholder API data | | @bpmnkit/casen-worker-ai | AI task worker — classify, summarize, extract, and decide using Claude |

License

MIT © BPMN Kit — made by u11g