{"skill":{"slug":"planka","displayName":"Planka","summary":"Manage Planka (Kanban) projects, boards, lists, cards, and notifications via a custom Python CLI.","description":"---\nname: planka\ndescription: Manage Planka (Kanban) projects, boards, lists, cards, and notifications via a custom Python CLI.\nmetadata: {\"clawdbot\":{\"emoji\":\"📋\",\"requires\":{\"bins\":[\"planka-cli\"]}}}\n---\n\n# Planka CLI\n\nThis skill provides a CLI wrapper around the `plankapy` library to interact with a Planka instance.\n\n## Setup\n\n1.  **Install via Homebrew tap:**\n    ```bash\n    brew tap voydz/homebrew-tap\n    brew install planka-cli\n    ```\n\n    Source/pipx installs require Python 3.11+ to use plankapy v2.\n\n2.  **Configuration:**\n    Use the `login` command to store credentials:\n    ```bash\n    planka-cli login --url https://planka.example --username alice --password secret\n    # or: python3 scripts/planka_cli.py login --url https://planka.example --username alice --password secret\n    ```\n\n## Usage\n\nRun the CLI with the installed `planka-cli` binary:\n\n```bash\n# Show help\nplanka-cli\n\n# Check connection\nplanka-cli status\n\n# Login to planka instance\nplanka-cli login --url https://planka.example --username alice --password secret\n\n# Remove stored credentials\nplanka-cli logout\n\n# List Projects\nplanka-cli projects list\n\n# List Boards (optionally by project ID)\nplanka-cli boards list [PROJECT_ID]\n\n# List Lists in a Board\nplanka-cli lists list <BOARD_ID>\n\n# List Cards in a List\nplanka-cli cards list <LIST_ID>\n\n# Show a Card (includes attachments with URLs and comment text)\nplanka-cli cards show <CARD_ID>\n\n# Create a Card\nplanka-cli cards create <LIST_ID> \"Card title\"\n\n# Update a Card\nplanka-cli cards update <CARD_ID> --name \"New title\"\nplanka-cli cards update <CARD_ID> --list-id <LIST_ID>\nplanka-cli cards update <CARD_ID> --list-id <LIST_ID> --position top\n\n# Delete a Card\nplanka-cli cards delete <CARD_ID>\n\n# Notifications\nplanka-cli notifications all\nplanka-cli notifications unread\n```\n\n## Examples\n\n**List all boards:**\n```bash\nplanka-cli boards list\n```\n\n**Show cards in list ID 1619901252164912136:**\n```bash\nplanka-cli cards list 1619901252164912136\n```\n\n**Show card details for card ID 1619901252164912137:**\n```bash\nplanka-cli cards show 1619901252164912137\n```\n\n**Create a card in list ID 1619901252164912136:**\n```bash\nplanka-cli cards create 1619901252164912136 \"Ship CLI\"\n```\n\n**Move a card to another list:**\n```bash\nplanka-cli cards update 1619901252164912137 --list-id 1619901252164912136\n```\n\n**Move a card to another list and pin it to the top:**\n```bash\nplanka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top\n```\n\n**Mark a card done by updating its name:**\n```bash\nplanka-cli cards update 1619901252164912137 --name \"Done: Ship CLI\"\n```\n","tags":{"latest":"0.1.12"},"stats":{"comments":0,"downloads":2719,"installsAllTime":4,"installsCurrent":4,"stars":1,"versions":2},"createdAt":1769526155409,"updatedAt":1778987228014},"latestVersion":{"version":"0.1.12","createdAt":1770199283208,"changelog":"No changes were detected in this version.\n\n- Updated according to binary 0.1.12","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"voydz","userId":"s1786pxseytgsv02g8sft4qrms87dypm","displayName":"Voydz","image":"https://avatars.githubusercontent.com/u/373533?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779916963685}}