planka

name	planka
description	Manage tasks and projects in Planka kanban board — create cards, move between columns, track progress. Use when creating tasks, updating card status, checking project boards, managing the kanban workflow, or organizing work items.

Planka Skill

Manage tasks and projects using the Planka kanban board.

Actions

Action	Description
create	Create a new card in a list
list	List cards, optionally filtered by list or label
get	Get details for a specific card (includes comments and tasks)
move	Move a card to a different list
complete	Move a card to the done list
update	Update card title, description, or labels
comment	Add a comment to a card
delete	Delete a card
boards	List available boards
labels	List available labels

Usage

python3 {baseDir}/planka.py [--board <name>] <command> [options]

Create a new card

When creating cards, use the template in {baseDir}/references/card-template.md to structure the card description. Fill in each section (Goal, Context, Requirements, Considerations, Acceptance Criteria) based on the task at hand.

Add the human label for tasks created by or intended for a human, and the agent label for tasks the agent should work on autonomously.

python3 {baseDir}/planka.py create \
  --title "Review image prompts" \
  --description "$(cat <<'CARD'
## Goal

Check prompt quality and consistency across generated images.

## Context

Recent image generations have shown inconsistent styling. Need a review pass.

## Requirements

1. **Audit**: Review last 20 generated prompts for style consistency
2. **Scope**: Focus on character prompts first

## Acceptance Criteria

- [ ] All prompts reviewed and scored
- [ ] Inconsistent prompts flagged for revision
CARD
)" \
  --list "next up" \
  --labels "agent"

List cards

# List all cards on the default board
python3 {baseDir}/planka.py list

# Filter by column
python3 {baseDir}/planka.py list --list "next up"

# Filter by label
python3 {baseDir}/planka.py list --label "priority"

# Different board
python3 {baseDir}/planka.py --board dev list

Get card details

python3 {baseDir}/planka.py get <card-id>

Move a card

# Board is auto-detected from the card — no --board needed
python3 {baseDir}/planka.py move <card-id> --list "next up"

Mark card complete

python3 {baseDir}/planka.py complete <card-id>

Add a comment

python3 {baseDir}/planka.py comment <card-id> --text "Progress update: completed initial review"

List boards / labels

python3 {baseDir}/planka.py boards
python3 {baseDir}/planka.py labels

Environment Variables

Required:

• PLANKA_API_URL: Base URL of Planka instance
• PLANKA_API_TOKEN: API authentication token

Optional:

• PLANKA_USERNAME: Login username (for auto-refresh when token expires)
• PLANKA_PASSWORD: Login password (for auto-refresh)
• PLANKA_BOARD: Default board name (default: first configured board)

Board Configuration

Boards are configured as a JSON dict in the PLANKA_BOARDS environment variable, or directly in planka.py. Each entry maps a short name to a Planka board ID.

# Example: set via environment
export PLANKA_BOARDS='{"main": "123456789", "dev": "987654321"}'

Or edit the BOARD_IDS dict in planka.py:

BOARD_IDS = {
    "main": "123456789",
    "dev": "987654321",
}

Typical Board Columns

1. Backlog — Future tasks
2. Next Up — Ready to work on
3. Progress — Currently being worked on
4. Blocked — Waiting on external dependency
5. Done — Completed

Notes

• List names are matched case-insensitively
• move and complete auto-detect the board from the card ID
• The script includes automatic retry (3 attempts with backoff) and token refresh
• --board flag goes before the subcommand: planka.py --board dev list