Felix Rudat
94 lines
2.1 KiB
Markdown
94 lines
2.1 KiB
Markdown
# 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)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
planka-cli login --url https://planka.example --username alice --password secret
|
|
```
|
|
|
|
### Run
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
export PLANKA_URL=https://planka.example
|
|
export PLANKA_USERNAME=alice
|
|
export PLANKA_PASSWORD=secret
|
|
```
|
|
|
|
## Common commands
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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.
|