360 Secure SkillHub
360 安全技能中心

Plane CLI

封装 Plane.so 项目管理的命令行工具用法：通过 plane CLI 创建、查询、更新、删除项目、任务（issues）、评论、状态、标签与页面，默认输出 JSON，凭据可放在配置文件或环境变量中，删除类命令需确认。

jzakirov
jzakirov
热度 53.07
最近更新 2026-05-11 17:29:02
分类：协作依赖：代码执行 / 第三方 API应用场景：任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add plane-cli-tool
Metadata
name
plane-cli
version
0.1.0
description
Plane.so: Create, update, and manage issues, projects, states, labels, and pages. Use when the user wants to interact with Plane.so — creating issues, listing tasks, updating status, managing labels, or any project-management workflow.
metadata
{"openclaw":{"emoji":"✈️","category":"productivity","requires":{"bins":["plane"],"env":["PLANE_API_KEY","PLANE_WORKSPACE_SLUG"]},"cliHelp":"plane --help"}}

Plane CLI

CLI for Plane.so project management. Output is JSON by default — pipe to jq or consume directly.

Setup

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.

Command Discovery

Do not guess command names or options. Use --help:

plane --help
plane issues --help
plane issues create --help

Quick Reference

Resource Key commands
plane projects list, get, create --name, update, delete
plane issues list, get, create --title, update, delete
plane issues comment list <issue-id>, add <issue-id> --body
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

Common Workflows

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 -

Important Conventions

  • --project is optional when defaults.project is configured
  • Destructive commands (delete) 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
  • Errors go to stderr as JSON: {"error": {"type": "...", "message": "...", "status_code": N}}
  • Exit codes: 0 success, 1 error, 2 rate-limited (retry safe)

[!CAUTION] delete commands are destructive — always confirm with the user before executing.