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:** ```bash 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: ```bash 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:

```bash # 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:** ```bash planka-cli boards list ```

**Show cards in list ID 1619901252164912136:** ```bash planka-cli cards list 1619901252164912136 ```

**Show card details for card ID 1619901252164912137:** ```bash planka-cli cards show 1619901252164912137 ```

**Create a card in list ID 1619901252164912136:** ```bash planka-cli cards create 1619901252164912136 "Ship CLI" ```

**Move a card to another list:** ```bash planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 ```

**Move a card to another list and pin it to the top:** ```bash planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top ```

**Mark a card done by updating its name:** ```bash planka-cli cards update 1619901252164912137 --name "Done: Ship CLI" ```