# Plane CLI

> Plane (developers.plane.so) CLI powered by Api2Cli (a2c). Includes an a2c workspace (plane) plus a wrapper script to list workspaces/projects, fetch issues (work items), set issue state, and add HTML comments.

- Skill: `modbender/plane-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/plane-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/plane-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/plane-cli

---


# plane-cli

A thin OpenClaw skill wrapper around the **Plane API** using **Api2Cli (a2c)**.

This skill ships:
- an `a2c/` workspace named **`plane`**
- a wrapper script: `scripts/plane`

## Requirements

- `a2c` installed and available on `PATH`
- Plane credentials in env:
  - `PLANE_API_KEY` (required)
  - `PLANE_BASE_URL` (optional; defaults to `https://api.plane.so`)

## Usage

Call via the wrapper script (recommended):

```bash
./scripts/plane --help
./scripts/plane whoami
./scripts/plane get_workspaces
./scripts/plane projects <workspace_slug>
./scripts/plane states <workspace_slug> <project_uuid>
./scripts/plane workitems <workspace_slug> <project_uuid>
./scripts/plane workitem <workspace_slug> <project_uuid> <issue_uuid>
./scripts/plane set-state <workspace_slug> <project_uuid> <issue_uuid> <state_uuid>
./scripts/plane comment <workspace_slug> <project_uuid> <issue_uuid> '<p>Hello</p>'
```

Notes:
- Plane “work items” are called **issues** in the Plane API.
- `set-state` sends `{"state_id": "..."}`.
- `comment` sends `{"comment_html": "<p>...</p>"}`.

## Smoke test

```bash
# 1) Help works
./scripts/plane --help

# 2) Auth sanity check (requires valid env)
export PLANE_API_KEY="plane_api_..."
export PLANE_BASE_URL="https://api.plane.so"  # optional
./scripts/plane whoami
```