CLI 概要

suya CLI は Subaya への主要インターフェースです — 人間にも、AI エージェントにも、CI にも 同じように。プラットフォームを通じてできることはすべてここから始まります。 subaya-dev.com の Web コンソールは、結果、波形、レポート、レビュー のためのものです。メンタルモデルについては コアコンセプト を、 インストールから合格するシミュレーションまでは クイックスタート をご覧ください。

グローバルフラグ

これらのフラグはすべてのコマンドで機能します:

フラグ	説明
--host <url>	ターゲット API ホスト。デフォルトは https://subaya-dev.com。
--token <token>	この呼び出しに明示的な認証トークンを使用する。
--json	機械可読の JSON 出力を出す。
--pretty	人間向けに整形して出力する。
-q, --quiet	必須でない出力を抑制する。
-v, --verbose	追加の診断詳細を出力する。

--json はエージェントや CI と相性がよく、--pretty はターミナル向けの親しみやすい デフォルトです。

プロジェクト設定 — .subaya/config.toml

ほとんどのプロジェクトスコープのコマンドは、デフォルトの --project をローカルの .subaya/config.toml ファイルから読み取ります。ディレクトリでプロジェクトが初期化されると （suya project を参照）、suya project show、suya sim run、 suya repo status などのコマンドは、毎回 --project を渡さなくてもそのプロジェクトに 対して動作します。上書きするには --project <project-id> を明示的に渡してください。

認証

2 つのモードが同じ API に対して解決されます — 詳細は 認証と API キー と suya auth リファレンスにあります:

• SUBAYA_API_KEY — エージェントと CI 向けの環境変数。ブラウザ不要。
• suya auth login — 人間の開発者向けの OAuth ブラウザフロー。

export SUBAYA_API_KEY="sk_..."
suya auth whoami

コマンドグループ

グループ	機能
suya auth	サインイン、サインアウト、自分のアイデンティティの検査。
suya project	プロジェクトとフェーズの作成、一覧表示、管理。
suya sim	クラウドシミュレーションを実行し、結果を検査する。
suya hw	ハードウェア検証の実行とエージェント管理（BitCrucible）。
suya rag	ナレッジベースを検索して読む。
suya plan	計画ドキュメント、ワークアイテム、ダイアグラム。
suya repo	プロジェクト用の GitHub リポジトリを作成または接続する。
suya device	デバイスカタログを閲覧してデバイスを割り当てる。
Session	suya attach / suya detach でセッションポッドを操作する。

その他のコマンドグループ

これらのグループはサーフェスを完成させます:

• suya arch — アーキテクチャと組み込みのピンプランニング（モジュール、ピンプラン、ペリフェラル/クロック設定、validate、generate、.ioc コミット）。
• suya req — プロジェクトの要件の追加と一覧表示（suya req add、suya req list）。
• suya review — コードと設計のレビュー（create、show、list、comment、reply、resolve、approve など）。
• suya diagram — Mermaid ダイアグラムの作成と SVG/PNG へのレンダリング（create、update、show、list、export、render、delete）。

トップレベルコマンド

コマンド	説明
suya version	バージョンのメタデータを表示する。
suya update [--check]	最新リリースにアップグレードする。--check は可用性を報告するだけ。
suya install [--skills] [--path <p>] [--force]	Subaya 統合（suya-cli + planner スキルバンドル）をインストールする。
suya completion <shell>	指定したシェル向けのシェル自動補完を出力する。