The gezel command line

The gezel command drives the same service the desktop app uses — handy on servers, in scripts, or when you just live in a terminal.

Install the command-line package with Node.js 24 or newer:

npm install -g @bendyline/gezel-cli
gezel

The CLI is one of Gezel's public JavaScript packages. See Gezel on npm for the complete package map and the SDKs to use when a shell command is not the right integration boundary.

Everyday commands

gezel start                 ensure the service is running
gezel start --port 8080 --foreground
                            run it attached, on a fixed port
gezel status                is it up, and where
gezel stop                  stop it
gezel run "..."             one-shot: send a prompt, print the reply

Working with the crew

gezel agent list            your gezellen
gezel task list             tasks in flight
gezel env skills list       importable skills

This documentation

gezel handboek export --out ./site

renders the Handboek — the same articles you're reading now — as a static website, for publishing or offline reading.

Run gezel --help (or --help on any subcommand) for the full surface.

To automate work inside a project, continue with Writing scripts with gezel-sdk. To let another application use Gezel, see Building connected apps with gezel-app-sdk.