CLIリファレンス

pip install shannon-sdk

shannon --help

git clone https://github.com/Kocoro-lab/Shannon.git
cd Shannon/clients/python
pip install -e .

shannon --base-url http://localhost:8080 submit "Hello world" --wait

shannon --base-url http://localhost:8080 --api-key YOUR_API_KEY \
  submit "Hello world" --wait

export SHANNON_BASE_URL=http://localhost:8080   # または http://localhost:8080
export SHANNON_API_KEY=sk_your_key_here
# export SHANNON_BEARER_TOKEN=eyJ...    # APIキーの代替

shannon submit "Hello world" --wait

shannon [--base-url URL] [--api-key KEY] [--bearer-token TOKEN] COMMAND [OPTIONS]

shannon submit QUERY [OPTIONS]

# シンプルなタスク
shannon submit "2+2は？" --wait

# ディープリサーチ（引用付き）
shannon submit "量子コンピューティングの最新進展" \
  --force-research --research-strategy deep --wait

# コスト最適化
shannon submit "このテキストを要約" --model-tier small --mode simple --wait

# モデルとプロバイダーを指定
shannon submit "トレンドを分析" --model-override gpt-5-nano-2025-08-07 --provider-override openai --wait

# マルチエージェントswarm
shannon submit "AI ワークロード向けトップ3クラウドプロバイダーを比較" --swarm --wait

# セッションに紐付け
shannon submit "フォローアップ質問" --session-id my-session --wait

shannon status TASK_ID

shannon cancel TASK_ID [--reason REASON]

shannon pause TASK_ID [--reason REASON]

shannon resume TASK_ID [--reason REASON]

shannon control-state TASK_ID

shannon stream WORKFLOW_ID [OPTIONS]

# 全イベントをストリーミング
shannon stream workflow-xyz789

# LLM出力と完了イベントのみ
shannon stream workflow-xyz789 --types LLM_OUTPUT,WORKFLOW_COMPLETED

shannon review-get WORKFLOW_ID

shannon review-feedback WORKFLOW_ID MESSAGE [--version N]

shannon review-approve WORKFLOW_ID [--version N]

shannon approve APPROVAL_ID WORKFLOW_ID [--approve | --reject] [--feedback TEXT]

# 承認
shannon approve approval-001 workflow-xyz789 --feedback "問題なし"

# 拒否
shannon approve approval-001 workflow-xyz789 --reject --feedback "修正が必要"

shannon session-list [--limit N] [--offset N]

shannon session-get SESSION_ID [--no-history]

shannon session-title SESSION_ID TITLE

shannon session-delete SESSION_ID

shannon schedule-create NAME CRON QUERY [OPTIONS]

分  時  日  月  曜日
 0   9   *   *  1-5     = 平日9:00
 0  */4   *   *   *     = 4時間ごと
 0   0   *   *   1      = 毎週月曜日0:00

shannon schedule-create "毎日AIニュース" "0 9 * * *" "最新AIニュース要約" \
  --timezone Asia/Tokyo --force-research --research-strategy quick

shannon schedule-list [--page N] [--page-size N] [--status ACTIVE|PAUSED]

shannon schedule-get SCHEDULE_ID

shannon schedule-update SCHEDULE_ID [--name N] [--cron C] [--query Q] [--timezone T] [--budget B] [--timeout T] [--clear-context]

shannon schedule-pause SCHEDULE_ID [--reason REASON]

shannon schedule-resume SCHEDULE_ID [--reason REASON]

shannon schedule-delete SCHEDULE_ID

shannon schedule-runs SCHEDULE_ID [--page N] [--page-size N]

shannon tools-list [--category CATEGORY]

shannon tools-list

Name                      Description
--------------------------------------------------------------------------------
web_search                Search the web for information
calculator                Evaluate mathematical expressions

shannon tool-get NAME

shannon tool-get web_search

shannon tool-exec NAME [--arguments JSON] [--session-id ID]

shannon tool-exec web_search --arguments '{"query": "Shannon AI"}'

shannon agents-list

shannon agent-get AGENT_ID

shannon agent-exec AGENT_ID --input JSON [--session-id ID] [--stream]

shannon agent-exec agent-001 --input '{"query": "Q4のトレンドを分析"}'

shannon swarm-message WORKFLOW_ID MESSAGE

shannon swarm-message workflow-xyz789 "コスト分析に焦点を当ててください"

shannon session-files SESSION_ID [--path SUBDIR]

shannon session-files my-session

shannon session-file-get SESSION_ID PATH

shannon session-file-get my-session report.md

shannon memory-files

shannon memory-file-get PATH

shannon memory-file-get profile.md

shannon skills-list [--category CATEGORY]

shannon skill-get NAME

shannon skill-versions NAME