Planka

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
   

   Source/pipx installs require Python 3.11+ to use plankapy v2.

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>
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 unread

Examples

List all boards:

planka-cli boards list

Show cards in list ID 1619901252164912136:

planka-cli cards list 1619901252164912136

Show card details for card ID 1619901252164912137:

planka-cli cards show 1619901252164912137

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"