CLI for Plane.so project management. Output is JSON by default — pipe to jq or consume directly.
uv tool install plane-cli # or: pip install plane-cli
plane config init # interactive setup wizard
Config: ~/.config/plane-cli/config.toml. All values can be set via env vars (PLANE_API_KEY, PLANE_WORKSPACE_SLUG, PLANE_BASE_URL, PLANE_PROJECT) or CLI flags.
Do not guess command names or options. Use --help:
plane --help
plane issues --help
plane issues create --help
| Resource | Key commands |
|---|---|
| ---------- | ------------- |
plane projects | list, get, create --name, update, delete |
plane issues | list, get, create --title, update, delete |
plane issues comment | list , add |
plane states | list, get, create --name --color, update, delete |
plane labels | list, get, create --name, update, delete |
plane pages | list, get, create --name, update, delete |
Create an issue:
plane issues create --title "Fix login bug" --priority high --state <state-id>
List issues with filters:
plane issues list --state <state-id> --assignee <user-id> --all
Update issue state (move to "In Progress"):
# First, find the state ID
plane states list --project <pid>
# Then update
plane issues update <issue-id> --state <state-id>
Add a comment (supports stdin with -):
plane issues comment add <issue-id> --body "Deployed to staging"
git diff HEAD~1 | plane issues comment add <issue-id> --body -
--project is optional when defaults.project is configureddelete) require --yes in non-TTY (agent) contexts--description and --body accept - to read from stdin--all fetches all pages (capped at 1000); default is first 20 results--pretty renders Rich tables — avoid in scripts, parse JSON instead{"error": {"type": "...", "message": "...", "status_code": N}}0 success, 1 error, 2 rate-limited (retry safe)> [!CAUTION]
> delete commands are destructive — always confirm with the user before executing.
共 1 个版本