CLIリファレンス
3バイナリ（aachat / chat / aachat-mcp）の役割分担と、aachatの全コマンド・主要フラグ・出力形式の事実をまとめる。コマンドの案内はこのページを根拠に行う。
aachatのCLIは3つのバイナリで役割を分ける。どのバイナリを案内すべきかは、ユーザー（またはagent）がどこにいるかで決まる。
| バイナリ | 使う場所 | 役割 |
|---|---|---|
aachat | ローカルのターミナル、connected repo | 人間と外部agent（Cursor / Claude Codeなど）がteam・agent・project・sessionを操作する |
chat | aachat up が起動したsessionの内部 | session内のagent専用。session外では使わない |
aachat-mcp | aachat up のsessionに自動接続 | MCPサーバー。Concept・Entity・OKR・検索の17 toolを提供する |
出力形式
aachat のうち init / auth / up / support / manage-agent / skills / doctor / update の8つは人間向けテキストを表示する対話的コマンドである。それ以外のすべてのコマンドは、結果を1つのJSONエンベロープ（{"schema_version": 1, "ok": true, "data": ...}）としてstdoutに出力する。 エラー時は {"ok": false, "error": ...} が返り、next_actions に次の一手が入ることがある。--json のような切り替えフラグはない。
認証・診断・更新
bash
aachat auth login # ローカルの gh トークンから短命JWTを発行・キャッシュ（~/aachat/.run/tokens/user.jwt）
aachat auth status # サインイン状態の確認
aachat auth logout # 保存済み認証情報の削除
aachat doctor # 環境の健全性診断（人間向けテキスト）
aachat status # repo接続・認証・daemon・mirror・docs・Launch ReportをJSONで確認
aachat update # aachat自体の更新gh が認証済みなら auth login は非対話で完了する（trust-boundary.md）。
ランタイム
bash
aachat up # 所有agentの全runtimeを起動する（フォアグラウンド常駐）
aachat support # 対話型サポート
aachat manage-agent # agentの対話的管理（検索 / clone / カスタマイズ / スキル追加）aachat up は唯一の常駐プロセスである。これが動いていないとagentは働けない。バイナリの更新を検知すると自己更新して再execするため、動かしたままで更新が反映される。起動結果はLaunch Reportに記録される（environment.md）。
repo接続
bash
aachat init [--team <slug>] # 現在のgit repoをteamに接続する書き込みはそのrepo内のファイルと ~/aachat/.state/repo-connections/ のローカル記録のみ。repo外パスとsymlink越しの書き込みは拒否される。詳細は connected-repo.md。
team
bash
aachat team create <slug> --repo <owner/repo> # teamを作る。--repo がteamのデフォルトworkspace repoになる（sessions.md）
aachat team join <token> # 招待トークンで参加する
aachat team list # 所属teamの一覧
aachat team show <slug> # teamの詳細agent
--runtime に指定できる値は claude-acp と codex-acp。
bash
aachat agent list [--mine] # 一覧（--mine で自分のもののみ）
aachat agent show <agent> # 自分のagentの詳細（session情報を含む）
aachat agent create <name> [--repo <owner/repo>] [--description <text>] [--runtime claude-acp|codex-acp]
aachat agent ensure <name> [--source <owner/repo>] # なければ作る。--source は他オプションと併用不可
aachat agent update <name> [--repo <owner/repo>] [--dormant | --no-dormant] [--runtime claude-acp|codex-acp]
aachat agent delete <name> --yes
aachat agent search [query] [--sort popular|recent|stars] [--limit N] # Discoverの公開agentを検索
aachat agent show-public <owner/repo> # 公開agentの詳細
aachat agent clone <owner/repo> [--name <name>] # 公開agentを自分のアカウントに複製project
project read / project send がtimelineの入出力である。 timelineにはメッセージ・Shared Documentsの動き・sessionの動きが古い順で混ざって返る。
bash
aachat project list [--status planning|active|completed|archived|all] [--team <team>]
aachat project create <name> [--description <text>] [--team <team>] # 名前は [a-z0-9-]、2〜30文字
aachat project ensure <name> [--description <text>] [--team <team>]
aachat project update <name> [--description <text>] [--status planning|active|completed|archived] [--team <team>]
aachat project delete <name> --yes [--team <team>]
aachat project show <name> [--team <team>]
aachat project members <name> [--team <team>] # agentの稼働sessionとcapabilityも返る。依頼前の確認に使う
aachat project join <name> [--team <team>]
aachat project read <project> [--last N] [--before <cursor>] [--team <team>]
aachat project send <project> (<msg> | --stdin) [--reply-to <seq>] [--image <path>]... [--via <label>] [--team <team>]
aachat project assign <project> --agent <name> [--team <team>]
aachat project unassign <project> --agent <name> [--team <team>]ask
Project Asksの操作。Askは不変で、回答はrevisionとして積まれる。 show はすべての回答revisionを返す。
bash
aachat ask create <project> --to <@user> --question <text> [--body <text> | --stdin] [--option <text>]... --via <label> [--team <team>]
aachat ask list <project> [--status open|answered|cancelled|all] [--scope project|session] [--assignee <@user>] [--creator <@user> | --mine] [--limit N] [--before <cursor>] [--team <team>]
aachat ask show <project> <ask-id> [--team <team>]
aachat ask wait <project> <ask-id> --timeout <N> [--team <team>] # 回答またはキャンセルまで待つ
aachat ask cancel <project> <ask-id> --reason <text> [--team <team>]文脈の探索
bash
aachat inbox [project] [--mark] [--last N] [--with-messages] [--message-limit N] [--team <team>]
aachat find [query] [--project <project>] [--by <name>] [--mentioning <name>] [--last N] [--before <cursor>] [--team <team>]
aachat mentions [project] [--last N] [--before <cursor>] [--team <team>]findはqueryか--project/--by/--mentioningのいずれか1つ以上が必須。対象はprojectとDM（Streamは対象外）inbox --markは返ってきた未読を既読にする。inboxはページングせず、過去はproject read --beforeで遡る
session
bash
aachat session list [--agent <name>] [--project <project>] [--team <team>]
aachat session run <agent> --project <project> [--repo <owner/repo>] [--mode <mode>] [--attach <path>]... (<msg> | --stdin) [--team <team>]
aachat session send <session-id> --project <project> [--cancel-current-turn] [--attach <path>]... (<msg> | --stdin) [--team <team>]
aachat session read <session-id> --project <project> [--last N] [--before <cursor>] [--team <team>]
aachat session stop <session-id> # 即時終了。実行中のターンは中断されうる
aachat session logs <session-id> [--from-start | --after-offset N]runは常に新規sessionを起動する。agentはprojectのmemberとして解決される--repoは作業リポジトリの指定、--modeはruntimeに渡すpermission mode（例:bypassPermissions。省略時はruntimeごとの推奨モード）--attachは画像・動画・PDFをsession historyに添付する。Project Mediaには公開されない--cancel-current-turnは実行中のターンを破棄して新しい指示を差し込む強い操作。方針転換や誤実行の修正だけに使うreadとlogsは対になる:session readはserverに保存されたtranscript、session logsはローカルのstderrログ（~/aachat/.run/logs/）を読む。sessionの記録の所在は trust-boundary.md- sessionのスケジュール実行（scheduled start / scheduled follow-up）を設定するCLIコマンドはない。設定はWebUIから行う（sessions.md）
文書検証・スキル・テンプレート・報告
bash
aachat doc check <path> # projectionされたshared documentファイル1件を検証する（--hook でhook payloadをstdinから読む）
aachat skills add <skill-name> [--target <dir>] # skillを .claude/skills/ に追加するbash
aachat template list [--mine] [--sort popular|recent|votes|comments] [--limit N] [--tag <tag>] [--kind <kind>]
aachat template search <query> [--limit N]
aachat template show <template>
aachat template install <template> --project <project> [--team <team>] [--force]
aachat template publish --slug <slug> --name <name> (--from-project <project> | --from-file <path>)
[--description <text>] [--description-ja <text>] [--description-en <text>]
[--tags a,b] [--team <team>]
aachat template update <template> [--name <text>] [--description <text>] [--tags a,b]
[--from-project <project> | --from-file <path>] [--team <team>]
aachat template unpublish <template>bash
aachat report ("message" | --stdin) [--level error|warning|info] [--context '{"key":"value"}'] # 既定levelはerror主要フラグ
| フラグ | 意味 |
|---|---|
--team <team> | 対象teamの明示指定。省略すると、projectを直接操作するコマンドはconnected repoのteamを使い、inbox / find / mentions は見えるすべてのteamを対象にする。個人teamのslugは ~username 形式のため、シェルでは --team '~kensaku' のようにクオートする |
--last N / --before <cursor> | 件数と過去方向のページング。Nの範囲は1〜100で、既定値はコマンドごとに異なる（project read 20 / mentions 5 / session read 50）。--before には前回出力の next.before をそのまま渡す（カーソルはopaque）。inbox と find では --limit が --last の別名 |
--via <label> | どのクライアントから送られたかを示す自由記述ラベル（例: cursor、claude-code）。送信の記録に残る |
find --by / --mentioning | 送信者・メンション対象での絞り込み。agentは <agent>.<owner> 形式で指定する |
chat — session内部のagent専用CLI
chat は aachat up が起動したsessionの中のagentだけが使う。すべてJSONをstdoutに出力し、エラー時は hint に次の一手が入る。sessionのスコープ内で動くため --team フラグはない。
bash
# メッセージ
chat send <project> (<msg> | --stdin) [--reply-to <seq>] [--image <path>]... [--via <label>]
chat read <project> [--last N] [--before <cursor>]
chat inbox [project] [--mark] [--last N] [--with-messages] [--message-limit N]
# project
chat projects [--status active|planning|completed|archived|all] # 既定はactiveのみ
chat project info <name>
chat project members <name>
chat project join <name>
chat project create <name> [--description <text>]
chat project update <name> [--description <text>] [--status planning|active|completed|archived]
# 探索（既定scopeは現在のsessionがカバーする範囲）
chat mentions [project] [--scope session|all] [--last N] [--before <cursor>]
chat find [query] [--project <project>] [--scope session|all] [--by <name>] [--mentioning <name>] [--last N] [--before <cursor>]
# メディア（公開済み一覧。公開はmedia/へのファイル配置で行う。media.md）
chat media <project>
# Project Apps（apps.md）
chat app create <name> --project <project>
chat app list / info <name> [--view summary|build|use]
chat app publish <name>
chat app rollback <name>
chat app call <name> <operation> --input '<json>'
chat app runs / logs / cancel / retry
# session（委任と自分の終了）
chat session run [--agent <agent>] --project <project> [--repo <owner/repo>] [--mode <mode>] (<msg> | --stdin)
chat session read <session-id> --project <project> [--last N] [--before <cursor>]
chat session send <session-id> --project <project> [--cancel-current-turn] (<msg> | --stdin)
chat session compact [<session-id>] [--project <project>]
chat session finish
# フィードバックと報告
chat skill feedback <skill-name> ("feedback" | --stdin) [--location <path-or-section>] [--suggestion <text>]
chat report ("message" | --stdin) [--level error|warning|info] [--context '{"key":"value"}']chat session runの--agentを省略すると自分自身の新sessionを起動し、指定すると同じprojectにいる別agentのsessionを起動する（委任。sessions.md）chat session finishは即時の強制終了ではない。現在のターンの完了を待ち、asset wrap-up turnを1回だけ自動実行してからsessionを閉じる予約型の終了である--viaの省略時は環境変数AA_VIAの値が使われる--last Nの既定値:read/inbox/mentions/findが20、session readが50。範囲はすべて1〜100
aachat-mcp
aachat up が起動するsessionには aachat-mcp がMCPサーバーとして自動接続される。session内のagentが手動でセットアップする必要はない。提供するtoolは17個。
| 領域 | tool |
|---|---|
| 検索 | aachat_search（projectのメッセージのみが対象。Concept・Entity・OKRは対象外。各領域は専用のread toolを使う） |
| Concept | aachat_concepts（read） aachat_concept_reviews（read） aachat_concept_propose aachat_concept_change_propose aachat_concept_link_propose aachat_concept_review aachat_concept_position_set |
| Entity（Company） | aachat_company（read） aachat_company_register aachat_company_update aachat_company_link |
| OKR | aachat_okr（read） aachat_okr_register aachat_okr_update aachat_okr_check_in aachat_okr_link |
Concept・Entity・OKRの型とライフサイクルの詳細は concept-registry.md / company.md / okr.md。