cli-anything-seaclip 是做什麼的？
用於 SeaClip-Lite 專案管理的無狀態命令列介面。 透過 HTTP API 與直接 SQLite 讀取進行通訊。無需本地狀態或會話。
安裝
pip install -e .
先決條件：
- Python 3.10+
- SeaClip-Lite 後端運行於 localhost:5200
使用方式
基本指令
# 顯示幫助
cli-anything-seaclip --help
# 啟動互動式 REPL 模式
cli-anything-seaclip
# 以 JSON 輸出執行（供代理消費）
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list
REPL 模式
當不帶子指令呼叫時，CLI 會進入互動式 REPL 會話：
cli-anything-seaclip
# 以 Tab 補全與歷史記錄功能互動式輸入指令
指令群組
Issue（議題）
議題管理指令。
| 指令 | 說明 |
|---|---|
list | 列出議題（--status, --priority, --search, --limit） |
create | 建立新議題（--title, --description, --priority） |
move | 將議題移至欄位（ISSUE_ID --column COL） |
status | 更新議題狀態（ISSUE_ID --set STATUS） |
delete | 刪除議題（ISSUE_ID） |
Agent（代理程式）
管道代理指令。
| 指令 | 說明 |
|---|---|
list | 列出所有管道代理 |
Pipeline（管道）
管道控制指令。
| 指令 | 說明 |
|---|---|
start | 啟動管道（--issue UUID --mode auto/manual） |
status | 取得管道狀態（--issue UUID） |
resume | 繼續暫停的管道（--issue UUID） |
stop | 停止運行中的管道（--issue UUID） |
Scheduler（排程器）
排程配置指令。
| 指令 | 說明 |
|---|---|
list | 列出所有排程配置 |
add | 新增排程（--name, --cron, --repo） |
sync | 觸發同步（SCHEDULE_ID） |
Activity（活動）
活動饋送指令。
| 指令 | 說明 |
|---|---|
list | 近期活動（--limit N） |
Server（伺服器）
伺服器工具指令。
| 指令 | 說明 |
|---|---|
health | 檢查後端健康狀態 |
輸出格式
所有指令皆支援雙重輸出模式：
- 人類可讀（預設）：表格、色彩、格式化文字
- 機器可讀（
--json旗標）：結構化 JSON，供代理消費
# 人類輸出
cli-anything-seaclip issue list
# JSON 輸出（供代理使用）
cli-anything-seaclip --json issue list
給 AI 代理程式的注意事項
以程式化方式使用此 CLI 時：
- 務必使用
--json旗標以取得可解析的輸出 - 檢查回傳碼 - 0 表示成功，非零表示錯誤
- 解析 stderr以取得失敗時的錯誤訊息
- 錯誤回應在 JSON 模式中會包含
{"error": "message"}
版本
1.0.0