- 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
- Install via Homebrew tap:
brew tap voydz/homebrew-tap
brew install planka-cliSource/pipx installs require Python 3.11+ to use plankapy v2.
- 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 secretUsage
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>
# Show a Card (includes attachments with URLs and comment text)
planka-cli cards show <CARD_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 unreadExamples
List all boards:
planka-cli boards listShow cards in list ID 1619901252164912136:
planka-cli cards list 1619901252164912136Show card details for card ID 1619901252164912137:
planka-cli cards show 1619901252164912137Create 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 1619901252164912136Move a card to another list and pin it to the top:
planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position topMark a card done by updating its name:
planka-cli cards update 1619901252164912137 --name "Done: Ship CLI"