Plane CLI Integration for Openclaw

A lightweight Openclaw skill wrapping the Plane API via Api2Cli to manage workspaces, projects, and work items from the command line.

simonvanlaak
v0.1.0
Feb 27, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install plane-cli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install plane-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Plane CLI Integration?

Plane CLI is a specialized Openclaw skill designed to bridge the gap between your development workflow and the Plane project management platform. Built on top of the Api2Cli (a2c) framework, it provides a seamless way for developers and AI agents to interact with Plane.so workspaces, projects, and work items without leaving the terminal.

This integration ensures that your project tracking remains as agile as your code. By leveraging Openclaw Skills like Plane CLI, teams can automate status updates, retrieve issue details for context, and maintain project hygiene through simple terminal commands or agent-driven workflows.

Plane CLI Integration Use Cases

  • Automating issue state transitions during CI/CD pipelines or git hooks.
  • Quickly fetching work item details to provide context to an AI agent during coding sessions.
  • Listing workspaces and projects to navigate complex organizational structures.
  • Adding HTML comments to issues for automated logging or status reporting.
  • Synchronizing local development progress with Plane.so project boards.

How Plane CLI Integration Works

  1. The skill utilizes the a2c workspace configuration to map Plane API endpoints to CLI commands.
  2. Users authenticate by providing a PLANE_API_KEY as a required environment variable.
  3. The wrapper script handles request formatting, including optional base URL configuration for self-hosted Plane instances.
  4. Commands are executed through the provided script, which translates CLI arguments into API calls to manage work items, states, and comments.
  5. The resulting output can be consumed by the user or integrated into larger Openclaw Skills automation flows.

Plane CLI Integration Setup

First, ensure that a2c is installed and available in your PATH. Then, configure your environment variables to allow the skill to communicate with the Plane API:

export PLANE_API_KEY="your_api_key_here"
# Optional: default is https://api.plane.so
export PLANE_BASE_URL="https://api.plane.so"

Test the installation by running the internal help command:

./scripts/plane --help

Plane CLI Integration Data Schema & Taxonomy

Plane CLI organizes its interactions based on the Plane.so hierarchical structure. It uses the following metadata taxonomy to identify and manipulate resources:

Entity Identification Description
Workspace workspace_slug The unique string identifier for your workspace.
Project project_uuid The UUID representing a specific project.
Issue issue_uuid Referred to as a "work item" in this skill's logic.
State state_uuid The UUID corresponding to a workflow state (e.g., Done).
Comment HTML String The content added to an issue, strictly formatted as HTML.

Plane CLI Integration Advanced Features

  • Support for custom Plane API base URLs, facilitating use with self-hosted instances within the Openclaw Skills ecosystem.
  • Direct integration with Api2Cli (a2c) workspaces for highly extensible API interaction.
  • Granular control over issue states, allowing for programmatic workflow transitions.
  • HTML-formatted commenting support for rich-text updates on work items.
  • Lightweight wrapper design that minimizes overhead for AI agent execution.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins a2c
Github Stars: 0
forks: 0

Featured*