Skip to main content
Use the Plane CLI when you want to manage workers, payments, compensations, and events from your terminal.

​
Prerequisites

  • A Plane account
  • Access to your Plane workspace
  • macOS or Linux

​
Install the CLI

Run the Plane Terminalwire installer:
This installer also installs Terminalwire if it is not already available on your workstation.
Restart your terminal after installation so your shell picks up the CLI in PATH.

​
Verify the installation

Run:
You should see command groups including workers, payments, compensations, and events.

​
Sign in interactively

By default, plane login starts browser-based sign-in:
The CLI shows a verification code and URL, then prompts you to open your browser. After you complete sign-in, confirm your session:
To remove local CLI credentials:

​
Sign in with an API key prompt

If you prefer entering an API key in the terminal:
The key prompt is hidden input.

​
Use non-interactive authentication

For scripts, CI, and automation, set PLANE_API_KEY and run commands directly:
When PLANE_API_KEY is set, the CLI uses it for authentication instead of saved login state.

​
Use JSON output for automation

Functional commands print human-readable output by default. For machine-readable output, pass --json:
JSON mode returns deterministic payload envelopes and does not include interactive UI artifacts.

​
Next steps

Plane CLI commands

See examples for every currently supported command and option.

Plane CLI troubleshooting

Resolve common installation and authentication issues.