🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί My Plane
πŸ¦€ ClawHub

My Plane

by @honluk

Manage Plane.so projects and work items using the `plane` CLI. List projects, create/update/search issues, manage cycles and modules, add comments, and assig...

Versionv1.0.2
Downloads461
#clawhub
TERMINAL
clawhub install my-plane

πŸ“– About This Skill

name: my-plane description: "Manage Plane.so projects and work items using the plane CLI. List projects, create/update/search issues, manage cycles and modules, add comments, and assign members." metadata: {"moltbot":{"requires":{"bins":["plane"],"env":["PLANE_API_KEY","PLANE_WORKSPACE"]},"primaryEnv":"PLANE_API_KEY","emoji":"✈️","homepage":"https://github.com/HonLuk/my-plane","install":[{"id":"github","kind":"download","url":"https://github.com/HonLuk/my-plane/releases/latest/download/plane","targetDir":"~/.local/bin/","bins":["plane"],"label":"Download plane CLI from GitHub"}]}}

Plane Skill

Interact with Plane.so project management via the plane CLI.

Installation

Download the single executable file:

curl -L -o ~/.local/bin/plane https://github.com/HonLuk/my-plane/releases/latest/download/plane
chmod +x ~/.local/bin/plane

Make sure ~/.local/bin is in your PATH.

Setup

export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE="your-workspace-slug"

Optional: for self-hosted Plane (default: https://api.plane.so)

export PLANE_BASE_URL="https://api.plane.so"

Get your API key from: Plane β†’ Profile Settings β†’ Personal Access Tokens

The workspace slug is the URL path segment (e.g., for https://app.plane.so/my-team/ the slug is my-team).

Commands

Current User

plane me                      # Show authenticated user info

Workspace Members

plane members                 # List all workspace members (name, email, role, ID)

Projects

plane projects list                                      # List all projects
plane projects get PROJECT_ID                            # Get project details
plane projects create --name "My Project" --identifier "PROJ"  # Create project

Work Items (Issues)

# List work items
plane issues list -p PROJECT_ID
plane issues list -p PROJECT_ID --priority high --assignee USER_ID
plane issues list -p PROJECT_ID --state STATE_ID
Get details

plane issues get -p PROJECT_ID ISSUE_ID
plane issues get-short PROJ-SEQ  # e.g., PROJ-123 (fastest way)
Create

plane issues create -p PROJECT_ID --name "Fix login bug" --priority high
plane issues create -p PROJECT_ID --name "Feature" --assignee USER_ID --label LABEL_ID
Update

plane issues update -p PROJECT_ID ISSUE_ID --state STATE_ID --priority medium
Assign to members

plane issues assign -p PROJECT_ID ISSUE_ID USER_ID_1 USER_ID_2
Delete

plane issues delete -p PROJECT_ID ISSUE_ID
Search across workspace

plane issues search "login bug"

Comments

plane comments list -p PROJECT_ID -i ISSUE_ID            # List comments on a work item
plane comments list -p PROJECT_ID -i ISSUE_ID --all      # Show all activity (not just comments)
plane comments add -p PROJECT_ID -i ISSUE_ID "Looks good, merging now"  # Add a comment

Cycles (Sprints)

plane cycles list -p PROJECT_ID
plane cycles get -p PROJECT_ID CYCLE_ID
plane cycles create -p PROJECT_ID --name "Sprint 1" --start 2026-01-27 --end 2026-02-10

Modules

plane modules list -p PROJECT_ID
plane modules get -p PROJECT_ID MODULE_ID
plane modules create -p PROJECT_ID --name "Auth Module" --description "Authentication features"

States & Labels

plane states -p PROJECT_ID    # List workflow states (useful for getting state IDs)
plane labels -p PROJECT_ID    # List labels (useful for getting label IDs)

Output Formats

Default output is a formatted table. Add -f json for raw JSON:

plane projects list -f json
plane issues list -p PROJECT_ID -f json

Pagination

All list commands support cursor-based pagination. Pagination info is displayed above results:

plane projects list

Shows:


Pagination: total: 50 | pages: 5 | showing: 10


Next page: --cursor 10:1:0
Use cursor to navigate

plane issues list -p PROJECT_ID --cursor "10:1:0"
Control page size

plane issues list -p PROJECT_ID --per-page 20

Field Selection

# Return only specific fields
plane issues list -p PROJECT_ID --fields "id,name,state"
Expand related objects

plane issues list -p PROJECT_ID --expand "assignees,state"
Sort results

plane issues list -p PROJECT_ID --order-by "-created_at"

Getting Help

Every command has detailed help:

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

Typical Workflow

1. plane projects list β€” find your project ID 2. plane states -p PROJECT_ID β€” see available states 3. plane members β€” find member IDs for assignment 4. plane issues create -p PROJECT_ID --name "Task" --priority high --assignee USER_ID 5. plane comments add -p PROJECT_ID -i ISSUE_ID "Started working on this"

βš™οΈ Configuration

export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE="your-workspace-slug"

Optional: for self-hosted Plane (default: https://api.plane.so)

export PLANE_BASE_URL="https://api.plane.so"

Get your API key from: Plane β†’ Profile Settings β†’ Personal Access Tokens

The workspace slug is the URL path segment (e.g., for https://app.plane.so/my-team/ the slug is my-team).