Planka CLI

Cut through the UI and drive your Planka boards from the terminal. This CLI lets you scan work, create cards, and stay on top of notifications with fast, scriptable commands.

Why it exists

• Keep momentum without context switching to the browser.
• Script common workflows (triage, cleanup, nightly status pulls).
• Work with Planka from any machine that has Python installed.

Quick start

Requirements: Python 3.10+ and a Planka account.

Install (local or from Git)

# Local dev
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

# Or install from GitHub
pipx install git+https://github.com/voydz/planka-cli

Login

planka-cli login --url https://planka.example --username alice --password secret

Run

planka-cli status
planka-cli projects list
planka-cli boards list

Authentication

login stores credentials in a .env file next to the planka-cli binary (or next to scripts/planka_cli.py when running from source). You can also set credentials via environment variables:

export PLANKA_URL=https://planka.example
export PLANKA_USERNAME=alice
export PLANKA_PASSWORD=secret

Common commands

planka-cli status
planka-cli login --url https://planka.example --username alice --password secret
planka-cli logout

planka-cli projects list
planka-cli boards list [PROJECT_ID]
planka-cli lists list <BOARD_ID>
planka-cli cards list <LIST_ID>

planka-cli cards create <LIST_ID> "Card title" --description "Details"
planka-cli cards update <CARD_ID> --name "New title"
planka-cli cards delete <CARD_ID>

planka-cli notifications all
planka-cli notifications unread

Project layout

• scripts/planka_cli.py CLI entrypoint
• docs/ supporting documentation
• pyproject.toml packaging metadata
• Makefile helpers for setup and binary builds

Development

make setup
make run
make build

TBD

• Release workflow only builds the macOS binary.
• Release workflow assumes a GitHub release is already published.
• No signing/notarization or multi-platform release assets yet.