CLI

you-agent-factory のコマンドグループ、実行するファクトリーの選び方、全コマンド共通のグローバルフラグ、そして公開されている完全な CLI 契約の在り処を調べます。

インストール

お使いの OS 向けの公開リリースエントリポイントで you CLI をインストールし、最初の実行の前にプロバイダーを設定します。インストールページに、OS ごとのコマンド、プロバイダー設定の手順、パッケージ済みファクトリーのインストールがまとまっています。

you-agent-factory のインストール

コマンド

やりたいことからコマンドグループを選び、ファクトリーのホストがすでに待ち受けている必要があるかを確認してください。起動系はランタイムを作ります。セッション系・作業系・投入系はすでに存在するランタイムに問い合わせます。それ以外はローカルの状態を読み書きします。

コマンドグループ	用途	ファクトリーが稼働している必要があるか
you init	既定のプロバイダーとモデルを設定する、または組み込みカタログからパッケージ済みファクトリーをインストールする。	不要
you run	ファクトリーを読み込んでエンジンを実行する。既定はバッチ。アイドル中も生かし続けるには --continuously を付ける。	不要 — これがランタイムを起動する。
you server	./factory/factory.json の現在のファクトリーを検証して提供し、準備完了後にダッシュボードを 1 度開く。	不要 — これがランタイムを起動する。
you factory list / create / update / delete	一度に 1 つのファクトリールートの下で、永続化された名前付きファクトリーを管理する。	不要
you factory config validate / expand / flatten	定義を永続化せずに検証する、または単一ファイル形式と分割レイアウトを相互変換する。	不要
you session list / show / create / delete / pause / resume / dispatches	ホスト上のファクトリーセッションを管理し、永続化されたディスパッチを読む。	必要
you submit / you submit batch	稼働中のセッションに作業を 1 件投入する、または正規のリクエストバッチをアップサートする。	必要
you work list / show / move / visualize	作業項目を調べて移動させる。バッチファイルの可視化はローカル JSON を読む。	必要（visualize を除く）
you workers list / acp add / acp delete	選択可能なワーカー統合を調べ、Agent Client Protocol プロバイダーを設定する。	不要
you models list / inspect / pull / invoke	発見されたモデルと準備状態を読む、ローカルモデルを管理キャッシュに取得する、または直接呼び出す。	必要（invoke を除く）
you mcp serve	MCP ホスト向けに、Factory Session の Model Context Protocol サーバーを stdio で起動する。	不要
you serve acp	エディター向けに、you-agent-factory を Agent Client Protocol エージェントとして stdio でホストする。	不要
you docs / you docs <topic>	インストール済みバイナリから同梱リファレンスのマークダウンを表示する。	不要

CLI リファレンス — 公開されている全コマンド・フラグ・引数

ファクトリーの選択

実行にはどのファクトリーを読み込むかの指定が必要で、方法は 3 つあります。名前付きファクトリーは、まず ./factory から、次にグローバルなファクトリールートから解決されます。ディレクトリ指定はディスク上のファクトリーレイアウトを指します。ポータブルファクトリーは単一の JSON か YAML ファイル、または曖昧さのないディレクトリで、インストールせずにその場で実行します。

you run --named @you/goal "Ship the login bugfix"
you run --dir factory --work ./docs/examples/startup-work.json
you run --factory ./factory.yaml "Fix the lint issues"

セレクターを一切指定しない場合、実行は呼び出し元ディレクトリの ./factory/factory.json を現在のファクトリーとして検証します。定義が無い場合にブートストラップすることはなく、別の current-factory ポインターを追うこともありません。そのため、誤ったディレクトリでの実行は、黙って別のものを選ぶのではなく、何かが始まる前に失敗します。

グローバルフラグ

4 つのフラグがすべてのコマンドで使え、サブコマンドより前に書きます。構造化出力は標準出力に JSON を出し、診断は標準エラーに残します。これが CLI をスクリプトから扱える理由です。server フラグはファクトリー API のベース URI を指定します。HTTP クライアント系コマンドはそこを対象にし、サーバーを有効にした実行はそのループバックホストとポートにバインドします。

you --json factory list
you --server http://127.0.0.1:7437 session list
you --verbose run --named @you/review "Draft the release notes"

コマンドごとの --port フラグは非推奨で、グローバルな --server フラグに置き換わりました。ベース URI のほうを使ってください。スキーム、ホスト、ポートを 1 つの値で表し、全体に一律で適用されます。

オフラインリファレンス

バイナリは自身のリファレンストピックを内蔵しており、ネットワーク接続も稼働中のホストもなしに表示します。21 のトピックが、ファクトリーの作成、実行、設定、モックワーカー、記録と再生、ガード、関係、作業、セッション、オーケストレーター、JavaScript ワークフロー、MCP、ワークステーション、ワーカー、リソース、モデル、バッチ入力、テンプレートを網羅しています。

you docs
you docs agents

エージェントに YOU を使わせる方法

限界と前提

ここで扱うのはコマンドグループ、ファクトリーの選択、グローバルフラグです。コマンドごとの網羅的なフラグ、引数、終了コード、ライフサイクル状態は CLI リファレンスにあり、そこはインストール済みパッケージの契約から直接投影されていて、書き写したものではありません。HTTP の操作は API リファレンスにあります。

CLI