Planka CLI
This skill provides a CLI wrapper around the plankapy library to interact with a Planka instance.
Setup
- 1. Install via Homebrew tap:
CODEBLOCK0
Source/pipx installs require Python 3.11+ to use plankapy v2.
- 2. Configuration:
Use the
login command to store credentials:
CODEBLOCK1
Usage
Run the CLI with the installed planka-cli binary:
CODEBLOCK2
Examples
List all boards:
CODEBLOCK3
Show cards in list ID 1619901252164912136:
CODEBLOCK4
Show card details for card ID 1619901252164912137:
CODEBLOCK5
Create a card in list ID 1619901252164912136:
CODEBLOCK6
Move a card to another list:
CODEBLOCK7
Move a card to another list and pin it to the top:
CODEBLOCK8
Mark a card done by updating its name:
CODEBLOCK9
Planka CLI
该技能提供了围绕plankapy库的CLI封装，用于与Planka实例进行交互。
安装配置
- 1. 通过Homebrew tap安装：
bash
brew tap voydz/homebrew-tap
brew install planka-cli
源码/pipx安装需要Python 3.11+才能使用plankapy v2。
- 2. 配置：
使用login命令存储凭据：
bash
planka-cli login --url https://planka.example --username alice --password secret
# 或：python3 scripts/planka_cli.py login --url https://planka.example --username alice --password secret
使用方法
使用已安装的planka-cli二进制文件运行CLI：
bash
显示帮助信息
planka-cli
检查连接状态
planka-cli status
登录到Planka实例
planka-cli login --url https://planka.example --username alice --password secret
移除已存储的凭据
planka-cli logout
列出项目
planka-cli projects list
列出看板（可选按项目ID筛选）
planka-cli boards list [PROJECT_ID]
列出看板中的列表
planka-cli lists list
列出列表中的卡片
planka-cli cards list
显示卡片详情（包含附件URL和评论内容）
planka-cli cards show
创建卡片
planka-cli cards create 卡片标题
更新卡片
planka-cli cards update --name 新标题
planka-cli cards update ID> --list-id ID>
planka-cli cards update ID> --list-id ID> --position top
删除卡片
planka-cli cards delete
通知管理
planka-cli notifications all
planka-cli notifications unread
示例
列出所有看板：
bash
planka-cli boards list
显示列表ID为1619901252164912136中的卡片：
bash
planka-cli cards list 1619901252164912136
显示卡片ID为1619901252164912137的卡片详情：
bash
planka-cli cards show 1619901252164912137
在列表ID为1619901252164912136中创建卡片：
bash
planka-cli cards create 1619901252164912136 发布CLI
将卡片移动到另一个列表：
bash
planka-cli cards update 1619901252164912137 --list-id 1619901252164912136
将卡片移动到另一个列表并置顶：
bash
planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top
通过更新卡片名称标记为完成：
bash
planka-cli cards update 1619901252164912137 --name 已完成：发布CLI
