name: planka description: Manage Planka (Kanban) projects, boards, lists, cards, and notifications via a custom Python CLI. metadata: {"clawdbot":{"emoji":"📋","requires":{"bins":["planka-cli"]}}}

Planka CLI

This skill provides a CLI wrapper around the plankapy library to interact with a Planka instance.

Setup

1. Install via Homebrew tap:

   brew tap voydz/homebrew-tap
   brew install planka-cli

2. Configuration: Use the login command to store credentials:

   planka-cli login --url https://planka.example --username alice --password secret
   # or: python3 scripts/planka_cli.py login --url https://planka.example --username alice --password secret

Usage

Run the CLI with the installed planka-cli binary:

# Show help
planka-cli
 
# Check connection
planka-cli status
 
# Login to planka instance
planka-cli login --url https://planka.example --username alice --password secret
 
# Remove stored credentials
planka-cli logout
 
# List Projects
planka-cli projects list
 
# List Boards (optionally by project ID)
planka-cli boards list [PROJECT_ID]
 
# List Lists in a Board
planka-cli lists list <BOARD_ID>
 
# List Cards in a List
planka-cli cards list <LIST_ID>
 
# Create a Card
planka-cli cards create <LIST_ID> "Card title"
 
# Update a Card
planka-cli cards update <CARD_ID> --name "New title"
planka-cli cards update <CARD_ID> --list-id <LIST_ID>
planka-cli cards update <CARD_ID> --list-id <LIST_ID> --position top
 
# Delete a Card
planka-cli cards delete <CARD_ID>
 
# Notifications
planka-cli notifications all
planka-cli notifications unread

Examples

List all boards:

planka-cli boards list

Show cards in list ID 1619901252164912136:

planka-cli cards list 1619901252164912136

Create a card in list ID 1619901252164912136:

planka-cli cards create 1619901252164912136 "Ship CLI"

Move a card to another list:

planka-cli cards update 1619901252164912137 --list-id 1619901252164912136

Move a card to another list and pin it to the top:

planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top

Mark a card done by updating its name:

planka-cli cards update 1619901252164912137 --name "Done: Ship CLI"