cli-anything-seaclip は何をしますか？
SeaClip-Liteプロジェクト管理のためのステートレスなコマンドラインインターフェースです。 HTTP APIと直接SQLite読み取りを介して通信します。ローカル状態やセッションは保持しません。
インストール
pip install -e .
前提条件:
- Python 3.10+
- localhost:5200 で動作している SeaClip-Lite バックエンド
使い方
基本コマンド
# ヘルプを表示
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モード
サブコマンドなしで呼び出すと、対話型REPLセッションが開始されます:
cli-anything-seaclip
# タブ補完と履歴機能付きで対話的にコマンドを入力
コマンドグループ
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 | バックエンドのヘルスチェックを実行 |
出力フォーマット
すべてのコマンドは2つの出力モードをサポートしています:
- 人間向け（デフォルト）: 表、色付き、整形済みテキスト
- 機械向け（
--jsonフラグ）: エージェントが消費しやすい構造化JSON
# 人間向け出力
cli-anything-seaclip issue list
# エージェント向けJSON出力
cli-anything-seaclip --json issue list
AIエージェント向け
このCLIをプログラム的に使用する場合:
- 常に
--jsonフラグ を使用して解析可能な出力を取得する - 戻りコードを確認する - 0は成功、非0はエラー
- 失敗時は stderrを解析 してエラーメッセージを取得する
- エラーレスポンスはJSONモードで
{"error": "message"}を含む
バージョン
1.0.0