cli-anything-seaclip

cli-anything-seaclip

SeaClip-Lite プロジェクト管理用のステートレスなコマンドラインインターフェースです。 HTTP API 経由および SQLite の直接読み取りによって通信します。ローカル状態やセッションは持ちません。

インストール

pip install -e .

前提条件:

• Python 3.10+
• localhost:5200 で実行中の SeaClip-Lite バックエンド

使用方法

基本コマンド

# Show help
cli-anything-seaclip --help

# Start interactive REPL mode
cli-anything-seaclip

# Run with JSON output (for agent consumption)
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list

REPL モード

サブコマンドを指定せずに起動すると、CLI は対話型の REPL セッションに入ります:

cli-anything-seaclip
# Enter commands interactively with tab-completion and history

コマンドグループ

Issue

Issue 管理コマンドです。

コマンド	説明
list	Issue を一覧表示します (--status, --priority, --search, --limit)
create	新しい Issue を作成します (--title, --description, --priority)
move	Issue をカラムに移動します (ISSUE_ID --column COL)
status	Issue のステータスを更新します (ISSUE_ID --set STATUS)
delete	Issue を削除します (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

# Human output
cli-anything-seaclip issue list

# JSON output for agents
cli-anything-seaclip --json issue list

AI エージェント向け

この CLI をプログラムから使用する場合:

1. 常に --json フラグを使用する — 解析可能な出力のため
2. 戻りコードを確認する — 0 は成功、非ゼロはエラー
3. 失敗時は stderr を解析する — エラーメッセージのため
4. エラー応答は JSON モードで {"error": "message"} を含みます

バージョン

1.0.0