Planka CLI

此技能提供了一个CLI包装器，围绕plankapy库，用于与Planka实例交互。

设置

1. 通过Homebrew tap安装：

   

   brew tap voydz/homebrew-tap
   brew install planka-cli
   

   源码/pipx安装需要Python 3.11+才能使用plankapy v2。

2. 配置：使用login命令存储凭据：

   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
   

使用

运行CLI，使用已安装的planka-cli二进制文件：

# 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

示例

列出所有看板：

planka-cli boards list

显示列表ID 1619901252164912136中的卡片：

planka-cli cards list 1619901252164912136

显示卡片ID 1619901252164912137的详细信息：

planka-cli cards show 1619901252164912137

在列表ID 1619901252164912136中创建卡片：

planka-cli cards create 1619901252164912136 "Ship CLI"

将卡片移动到另一个列表：

planka-cli cards update 1619901252164912137 --list-id 1619901252164912136

将卡片移动到另一个列表并置顶：

planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top

通过更新卡片名称来标记为已完成：

planka-cli cards update 1619901252164912137 --name "Done: Ship CLI"