Install Penstock
Pick your tool. It is the same editor, the same licence and the same 30-day Pro trial in all of them, with nothing to sign up for.
Penstock was published as Camunda BPMN Editor until 2026. It is the same plugin, and it updates in place, so nothing needs to be reinstalled.
JetBrains | VS Code | Command line
JetBrains IDEs
Any JetBrains IDE from 2023.1 with JCEF, which the standard downloads include: IntelliJ IDEA, WebStorm, PyCharm, GoLand, Rider and the rest.
- Open Settings | Plugins | Marketplace.
- Search for
Penstockand press Install. - Open any
.bpmnfile. It opens in the visual editor, with the XML one tab away. - The status bar shows the trial and the days left.
The Marketplace picks the build that fits your IDE. If you used to search for Camunda BPMN Editor, this is the same plugin. More in Installing in JetBrains and the quick start.
VS Code
VS Code 1.88 or later.
code --install-extension penstock.penstock
- Open a
.bpmnfile. It opens in the Penstock editor. - The Penstock view in the Activity Bar shows the project as a tree.
Cursor, Windsurf, VSCodium and other forks, or no access to the Marketplace
Editors built on VS Code take extensions from their own registry, usually Open VSX, and not from Microsoft's Marketplace. Where the extension cannot be found, install it from a .vsix file: Install from VSIX... in the Extensions view, or code --install-extension penstock.vsix. See Install from a VSIX file.
More in Installing in VS Code and the quick start.
Command line
Node.js 22.22.2 or later in 22, 24.15.0 or later in 24, or 26 and later.
| Way | Command | When |
|---|---|---|
| Try it without installing | npx @kern0x1b/penstock-cli check . | A one-off check |
| Install it | npm install -g @kern0x1b/penstock-cli | Your own machine |
| Let the project pin the version | npx @kern0x1b/penstock-cli init, then ./penstockw check . | A team and its pipeline, like gradlew |
The package is on npm. penstock doctor says what is wrong with a project. The command line is separate from the editors, and it shares their licence: one licence covers the JetBrains plugin, the VS Code extension and the command line. More in Command line and the quick start.
Other editors
Zed, Helix, Neovim, Sublime Text, Emacs, Kate and Eclipse can show Penstock's findings, hover, definitions, symbols, quick fixes and completion through the language server of the command line, with no plugin. It is free. Install the command line, then follow penstock lsp for your editor. Eclipse and Zed have no Penstock plugin, and the OpenIDEA plugin is not released.
Requirements
| JetBrains IDEs | Any JetBrains IDE from 2023.1 with JCEF. |
| VS Code | VS Code 1.88 or later. |
| Command line | Node.js 22.22.2 or later in 22, 24.15.0 or later in 24, or 26 and later. |
| Engines | Camunda 7, Camunda 8, Operaton, CIB seven, Flowable, Activiti and plain BPMN 2.0. Flowable and Activiti are not deployed to. |
| Systems | Windows, macOS and Linux. |
| Having trouble? | Troubleshooting, licence troubleshooting, oleksandr.havrysh5@gmail.com or GitHub issues. |
Your first ten minutes
- Write the example project into an empty folder. In a terminal:
penstock init --example camunda-8(orcamunda-7). The editors offer it too, in the Penstock view. - Open
order-process.bpmnand press Check. - Press Deploy to deploy it to an engine.
Getting started takes you from nothing installed to a checked, deployed process in about ten minutes.
What is free
The editors, the check and lint, deploy, Monitor, token simulation, export, share and import are free, with no time limit, and so are the element template editor, the connections map, the CMMN viewer and the language server. Every new machine also starts with 30 days of Pro. See pricing.
Uninstall and your data
Uninstalling removes the plugin or extension. Your diagrams are your own files and stay in your project. Penstock keeps its preferences and licence in ~/.penstock and secrets in your tool's secret store. See Files Penstock writes.