CLIコマンドリファレンス

anyyコマンドは、サブコマンドを指定せずに実行するとTUIを開きます。公開コマンドを使って、選択中のProfileと常駐Gatewayを設定・操作できます。

共通の起動方法

anyy [--profile NAME] [--profile-root PATH] [--role ROLE]
anyy [--profile NAME] [--profile-root PATH] [--role ROLE] COMMAND
anyy --version
anyy --resume SESSION_ID

--profile、--profile-root、--role、--no-colorなど、呼び出し時の選択用フラグはコマンドの前に置きます。既定のTUIでは、--home、--socket、--resumeをanyyの直後に指定します。サブコマンドを使う場合、そのサブコマンドが対応する--home/--socketフラグはサブコマンドの後に置いてください。前に置くと拒否されます。

フラグ	用途
--profile NAME	名前付きProfileを選ぶ
--profile-root PATH	Profile管理の基準ルートを上書きする
--role ROLE	新しい会話の初期Roleを選ぶ
--resume ID	IDが分かっているセッションをTUIで開く
--home PATH	TUIのHomeを選ぶ。または、対応するコマンドの後に置いてHomeを上書きする
--socket PATH	TUIのソケットを選ぶ。または、対応するコマンドの後に置いてソケットを上書きする
--no-color	ターミナルの色付き出力を無効にする
--version	バージョン情報を表示する

インストール済みのバージョンが対応する正確なフラグは、anyy COMMAND --helpで確認してください。

チャットとヘルスチェック

anyy / --resume

anyy
anyy --resume SESSION_ID

ターミナルインターフェースを開きます。必要に応じて、一つのセッションを再開できます。

anyy chat

anyy chat [--home PATH] [--socket PATH] [--role ROLE] \
  [--session ID] [--json] PROMPT

すでに稼働している常駐Gatewayを通じて、新しいプロンプトを一件送ります。--sessionは、そのプロンプトを送る既存の会話を選びます。会話が処理中の場合、入力はfollow-upキューに追加されます。--jsonは構造化された結果を返します。有効なツールは直接実行されます。既存の会話をTUIで開くにはanyy --resume IDを使います。キューの操作はセッションを参照してください。

成功時のJSON応答には、次のフィールドが含まれます。

フィールド	意味
session_id	入力を受け取る会話
submission_id	結果を待っていた、元の受け付け済み入力
execution_id	再利用可能なSessionの実行レーン
agent_run_id	回答を返した実際の実行
execution_state	観測されたレーンの状態。完了後は通常idle
outcome	その呼び出しの結果。succeededが成功を表す
stop_reason	完了または失敗の分類
assistant_text	その実行に記録された結果メッセージから取り出した、表示可能な回答

レーンがidleであるだけでは成功とは限りません。確認待ち（suspended）、失敗、中断、入力のクリア、タイムアウトでは、途中のアシスタント回答を表示せず、ゼロ以外の終了コードで終了します。タイムアウトや呼び出し元によるキャンセルは、監視だけを停止します。コマンドは元のsubmissionを追跡し続け、Sessionの最新メッセージで結果を置き換えることはありません。CLIインターフェースを参照してください。

会話で使うツールの選択

CLIは、既定のTUIとchatで次のフラグを受け付けます。対象のSessionで使うツールを選ぶものであり、GatewayやProfileの既定値は変えません。

フラグ	意味
--tools LIST, -t LIST	カンマ区切りの名前／パターン、または既定の選択に対する正確な+name/-name修飾子の一覧
--exclude-tools LIST, -xt LIST	除外する名前／パターンのカンマ区切り一覧
--no-tools, -nt	すべてのツールの既定の有効化を抑制して開始する
--no-builtin-tools, -nbt	拡張の既定値を維持し、組み込みツールの既定の有効化を抑制する

anyy --tools '+codemode,+tool_search'
anyy chat --tools 'read,bash' --exclude-tools 'bash' "Inspect this project"
anyy chat --session SESSION_ID --tools '' "Answer without tools"

通常のパターンは*に対応しています。修飾子の一覧に通常の名前を混在させたり、ワイルドカード付きの修飾子を使ったりすることはできません。空の--tools ''は、明示的に空の許可リストを指定します。空の--exclude-tools ''は、その除外指定の上書きを解除します。フラグはプロンプトの前に置きます。chatの前でも後でも指定できますが、コマンド内の一覧が、対応する共通の一覧を置き換えます。管理用コマンドでは、これらのフラグは拒否されます。

二つの抑制フラグは、Goの独立した真偽値フラグです。組み込みツールだけを対象にする場合は--no-builtin-toolsを使います。Piの--no-tools builtin構文には対応していません。両方指定した場合は--no-toolsが優先されます。Codemodeのon/onlyモードはProfile設定であり、--codemode-modeフラグはありません。

新しいSessionは、tool_selectionをsession.newを通じて受け取ります。既存のSessionに明示的なフラグを指定した場合、先にsession.tools.configureを呼び出します。作業の実行中、キュー内の入力、入力の受け入れ待ち、要約処理がある場合は競合となり、新しいチャット入力は送信されません。上書きを指定せず、すでに読み込まれているSessionへ接続した場合は、現在有効な名前を保持します。未読み込みの状態から保存データをそのまま復元する場合と、ブランチ移動では、選択したブランチの正規宣言を使います。これは、SDK形式で初期選択を明示する方法とは異なります。

ツールの復元、リソースの再読み込み、現在のSessionの設定は、セッションを参照してください。

ローカルプロンプト診断

anyy prompt eval local --authorize-live

分離された一時セッションで、現在のProfileのモデルを実際に呼び出します。料金が発生する場合があります。コマンドは応答、実際の利用量、所要時間を表示し、非公開のレポートを書き出します。--home PATHでProfileを選び、--output PATHで、一度だけ書き込むレポートの保存先を指定します。ターミナル出力とレポートは公開しないでください。この診断はチャンネルやcronを起動せず、モデルの品質を採点したり、Piとの整合性を認定したりするものでもありません。

anyy status

anyy status [--home PATH] [--socket PATH] [--json]

選択中のProfile／Gateway／ランタイムの状態を表示します。

anyy doctor

anyy doctor [--home PATH] [--config PATH] [--json]

設定とランタイムを診断します。

anyy config

anyy config [--home PATH] [--config PATH]

パス、プロバイダー／モデル、エンドポイント、認証情報参照の状態を、ターミナルの設定画面に表示します。設定の編集や、シークレットの値の表示は行いません。

初期設定とモデル

anyy setup

anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
  [--set INPUT=VALUE] [--sensitive-fd INPUT=FD] \
  [--external-locator-fd INPUT=FD]

対話式のFull／Quick setup、またはモデル／チャンネルに絞った設定を実行します。初期設定を参照してください。

anyy tools

anyy tools [--home PATH] [--probe]
anyy tools list [--home PATH]
anyy tools websearch [--home PATH]
anyy tools image [--home PATH] [--probe]
anyy tools image understanding [--home PATH] [--probe]
anyy tools image generation [--home PATH] [--probe]
anyy tools video [understanding] [--home PATH] [--probe]
anyy tools voice [--home PATH] [--probe]
anyy tools voice tts [--home PATH] [--probe]
anyy tools voice stt [--home PATH] [--probe]

任意のWeb、画像、動画、音声機能のバックエンドを設定します。

GatewayとDashboard

anyy gateway

anyy gateway start [--home PATH]
anyy gateway restart [--home PATH]
anyy gateway status [--home PATH]
anyy gateway stop [--home PATH]

常駐Gatewayのバックグラウンドサービスを管理します。

anyy dashboard

anyy dashboard [--home PATH] [--socket PATH] [--listen ADDR] [--no-open]
anyy dashboard --status
anyy dashboard --stop

必要に応じて動作するDashboardサイドカーを起動、確認、停止します。Dashboard概要を参照してください。

メッセージング

anyy channel

anyy channel doctor CHANNEL [--home PATH] [--socket PATH] [--json]
anyy channel pairing list [--channel CHANNEL] [--account ACCOUNT] [--all] [--json]
anyy channel pairing approve --request REQUEST
anyy channel pairing approve --prompt-code --channel CHANNEL --account ACCOUNT
anyy channel pairing approve --code-stdin --channel CHANNEL --account ACCOUNT
anyy channel pairing reject --request REQUEST
anyy channel pairing revoke --grant GRANT [--reason TEXT]
anyy channel reload [--home PATH] [--socket PATH] [--json]

Channelの診断、ペアリング要求の承認／拒否、許可の取り消し、ランタイム設定の再読み込みを行います。メッセージングプラットフォームを参照してください。

SkillsとMCP

anyy skills

anyy skills list [--home PATH] [--json]
anyy skills view [--home PATH] [--json] NAME [FILE_PATH]
anyy skills install [--home PATH] [--socket PATH] [--name NAME] [--force] [--now] [--json] ZIP_PATH
anyy skills uninstall [--home PATH] [--socket PATH] [--now] [--json] NAME
anyy skills rollback [--home PATH] [--socket PATH] [--revision REVISION_ID] [--now] [--json] NAME
anyy skills reload [--home PATH] [--socket PATH] [--json]

Skillsの確認、インストール、削除、ロールバック、再読み込みを行います。

anyy mcp

anyy mcp add SERVER_ID [--home PATH] --transport stdio --command CMD [--cwd DIR] [--env KEY=VALUE] [--disable] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --command CMD [--cwd DIR] [--exposure codemode|deferred|direct|hidden] [--tool-exposure JSON] [--description TEXT] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --url URL [--transport http] [--auth JSON] [--oauth JSON] [--header KEY=VALUE] [--exposure codemode|deferred|direct|hidden]
anyy mcp add SERVER_ID [--home PATH] --preset filesystem [-- ARG...]
anyy mcp add SERVER_ID [--home PATH] --local --url URL [--oauth JSON] [--header KEY=VALUE]
anyy mcp add SERVER_ID [--home PATH] --local --command CMD [--cwd DIR] [--env KEY=VALUE] [--args ARG...]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--exposure codemode|deferred|direct|hidden] [--enable]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--tool-exposure JSON] [--description TEXT]
anyy mcp login SERVER_ID [--home PATH] [--socket PATH] [--timeout SECONDS] [--json]
anyy mcp logout SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp remove SERVER_ID [--home PATH] [--force]
anyy mcp remove SERVER_ID [--home PATH] --local
anyy mcp enable SERVER_ID [--home PATH] [--project]
anyy mcp disable SERVER_ID [--home PATH] [--project]
anyy mcp set SERVER_ID KEY VALUE [--home PATH]
anyy mcp unset SERVER_ID KEY [--home PATH]
anyy mcp status [--home PATH] [--socket PATH] [--json]
anyy mcp list [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER.TOOL [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER_ID TOOL_NAME [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp show SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp probe SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp test SERVER_ID [--home PATH] [--socket PATH]
anyy mcp reload [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp logs [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp serve [--home PATH] [--socket PATH]

stdioまたはHTTPのMCPサーバー、認証、公開ツール、ランタイムの状態、直接呼び出しを管理します。トランスポートによってフラグが異なるため、サーバーを追加する前にanyy mcp --helpを実行してください。

addは既定で、必要時に接続する有効なサーバーを保存します。--disableで無効にできます。設定には公開方法と順序付き上書きルールを使い、ツール選択画面やProbeの成功は必須ではありません。RPCのtool_exposureには、順序付きJSONオブジェクトの文字列を渡します。Probeは、exposure/offeredの情報を含む一つのtools一覧を返します。

configure --exposure/--enableは、選択したソースまたは既存のプロジェクト上書きの設定を変更します。configure --description/--tool-exposureと、汎用のset/unsetは、元のProfile定義を編集します。二種類のconfigure対象を混在させると拒否されるため、別々のコマンドを実行してください。編集前にshowでソースを確認します。

add --cwd DIRはstdioサーバーにだけ適用されます。addと汎用のset SERVER_ID cwd VALUEは、入力した相対パス、絶対パス、ホーム表記で始まるパスを保持します。cwdの相対パスは、常駐ランタイムの正規Workspaceを基準にします。

通常のMCP設定値の書き込みでは、入力文字列と式の構文をそのまま保持します。機密情報らしいフィールド名でも、Secretとして自動保存しません。Profileに明示したenv:、secret:、file:参照は、それぞれの解決規則に従います。

--projectは、まだ上書きのないProfileサーバーの有効化／無効化にだけ適用され、有効化状態のみを含むプロジェクト上書きを書き込みます。--local（別名-l）は追加／削除だけに使い、Profileの正規Workspaceにある.anyy/mcp.jsonを書き込みます。ローカル追加は--forceなしで同名の項目を置換します。ローカル削除は、Profile設定と許可を保持します。どちらの操作も、稼働中の項目を再読み込みしません。Profile内のMCPサーバー定義を通常の方法で追加／削除する場合は、既存の確認手順と認証情報の扱いを維持します。

reloadはファイルを読み直さず、読み込み済みの設定で再接続します。起動時、またはアイドル状態でのsession.reload RPCは、Profileとプロジェクトのファイルを読み直します。ログインの--timeoutは既定300秒で、認可の段階だけを制限します。MCP設定を参照してください。

logoutは、選択したサーバーについて、対応するクライアント情報を含む、保存済みのローカルOAuth認可情報を削除します。サーバー定義は削除しません。常駐ランタイムが利用できる場合はそれを使い、利用できない場合はオフラインでProfileの排他的な所有権を取得する必要があります。

anyy mcp serveは、別のMCPクライアントからAnyyを利用できるようにします。messages_sendの結果は元のsubmissionを追跡し、確認待ちによる中断を、最終回答であるとみなさず報告できます。MCPの会話結果と待機APIリファレンスを参照してください。

自動化

anyy cron

anyy cron list [--home PATH] [--include-disabled] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --prompt TEXT \
  [--kind agent|skill|notify] [--skills LIST] [--role ROLE] [--workspace WORKSPACE] \
  [--delivery-target TARGET] [--delivery-channel CHANNEL] [--toolsets LIST] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --kind script --script NAME \
  [--workdir PATH] [--role ROLE] [--workspace WORKSPACE] [--delivery-target TARGET] [--json]
anyy cron update [--home PATH] --id ID [--enable|--disable] [--schedule SCHEDULE] [--prompt TEXT] \
  [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron delete [--home PATH] --id ID [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]

agent、skill、script、通知のジョブを作成します。種類を明示しない場合、--scriptを指定するとscript、それ以外は既定のagentになります。agent／skill／notifyジョブには--prompt、scriptジョブには--scriptが必要です。配信先はgateway、origin、current_user_default、noneから選びますが、自動化に記載するルートの条件に従います。スケジュール実行では、保存されたRole、Workspace、処理内容、配信ルートを使います。

anyy heartbeat

anyy heartbeat status [--home PATH] [--json]

常駐heartbeatの状態を表示します。

ProfileとRole

anyy profile

anyy profile list [--json]
anyy profile get NAME [--json]
anyy profile create NAME [--display-name NAME] [--json]
anyy profile use NAME [--json]
anyy profile delete NAME --force [--purge-secrets] [--json]

分離されたProfileのHomeを管理します。削除はデータを失う操作であり、--forceが必要です。

anyy role

anyy role list [--home PATH] [--include-archived] [--json]
anyy role get [--home PATH] ROLE_ID [--json]
anyy role create [--home PATH] ROLE_ID [--display-name NAME] [--json]
anyy role update [--home PATH] ROLE_ID [--display-name NAME] [--soul-file PATH] [--json]
anyy role use [--home PATH] ROLE_ID [--json]
anyy role delete [--home PATH] ROLE_ID [--json]

アシスタントのRoleとSoulの内容を確認・管理します。

バックアップ、保守、リリースの管理

anyy backup

anyy backup create [--home PATH] [--output PATH] [--include-secrets] [--json]
anyy backup restore --archive PATH --target-home PATH [--json]
anyy backup list [--home PATH] [--json]

Profileのバックアップを作成、一覧表示、復元します。--include-secretsは、管理対象のsecrets/とmcp/oauth/ディレクトリを追加で含めます。このフラグがなくても、設定ファイルやWorkspaceファイルには、直接書かれた認証情報がすでに含まれている場合があります。バックアップは、含まれるすべてのファイルの機密情報をマスキングするものではありません。すべてのアーカイブを非公開とし、機密データとして保護してください。収集範囲と復元手順は、バックアップと復元を参照してください。

anyy maintenance

anyy maintenance compact-state [--home PATH] (--output PATH | --replace) [--temp-dir PATH] [--json]
anyy maintenance checkpoint-state [--home PATH] [--json]
anyy maintenance cache-token-estimates [--home PATH] [--limit N] [--execute] [--json]

状態データベースとトークン推計の保守を行います。状態を置換するコマンドを使う前に、検証済みのバックアップを用意してください。

anyy update

anyy update [--home PATH] [--version VERSION] [--base-url URL]
anyy update --compact [--home PATH] [--version VERSION] [--base-url URL]
anyy update --check [--home PATH] [--version VERSION] [--base-url URL]

ネイティブの常駐インストールを確認または更新します。更新とアンインストールを参照してください。

anyy uninstall

anyy uninstall
anyy uninstall --keep-data --yes
anyy uninstall --full --yes
anyy uninstall --home PATH --keep-data --yes

ネイティブの常駐インストールを削除します。--keep-dataまたは--fullのどちらかを選んでから、--yes（-y）を使います。両方を併用することはできません。--home PATHはインストール先のHomeを選びます。--fullは対象範囲のAnyyデータもすべて削除するため、先にバックアップしてください。