ホームプログラムドキュメントFAQFAQyou-agent-factory についてよくある質問への短い回答。インストール、ファクトリーの実行、作成、エージェント、設定、復旧について、正式なドキュメントとリファレンスページを案内します。you-agent-factory とは何か。どこから始めるかyou-agent-factory は、長時間にわたるエージェントの作業を永続化し続ける CLI とワークフローシステムです。you という 1 つのバイナリとしてインストールされます。まず製品概要を読み、次にインストールしてパッケージ済みファクトリーを実行してから、CLI の詳細に進んでください。you-agent-factory とは最初のファクトリーを実行する you はどうやってインストールするかお使いのマシン向けの OS 別スクリプトでインストールし、シェルで you が解決できることを確認したうえで、ワーカーを実行するプロバイダーを設定します。コマンド一式はインストールページにあります。この FAQ では繰り返しません。インストール ファクトリーはどうやって実行するかyou init --package でパッケージ済みファクトリーをインストールし、you run --named に依頼を添えて名前で実行します。通常の実行はバッチモードで、HTTP リスナーを起動しません。そのため you session list が答えを返すのは、サーバー付きで実行を開始した場合か、you server が動いている場合だけです。最初のファクトリーを実行するCLIFactory Session バイナリにはどのファクトリーが同梱されているか組み込みカタログには 15 個のパッケージ済みファクトリーが含まれ、目標追跡、レビューループ、多数決とトーナメントによる比較、並列ファンアウト、計画立案、分類、ディープリサーチ、ファクトリーの自動作成、音声合成を網羅しています。各ファクトリーは自身の引数、既定値、実例を公開しています。パッケージ済みファクトリーリファレンスパッケージ済みファクトリー グラフファクトリーと JavaScript ファクトリーのどちらを書くべきかワークフローが作業の流れるトポロジーであり、項目ごとの永続的な状態と並行性を無料で得たい場合はグラフファクトリーを書きます。ワークフローが手続きであり、通常の制御構文を使いたい場合は JavaScript ファクトリーを書きます。orchestrator フィールドがエンジンを選び、省略するとグラフになります。最初のファクトリーを書くファクトリースキーマリファレンスJavaScript ランタイムリファレンス 設定はどこにあるかファクトリーごとのトポロジーは、ファクトリールート配下の factory.json にあります。ワーカーのプロバイダーなど運用者の既定値は ~/.you-agent-factory/config.json にあります。カタログからインストールした名前付きファクトリーは、別の場所を指定しない限り ~/.you-agent-factory/factories 配下に置かれます。設定グローバル設定ファクトリーシステム設定スキーマ AI エージェントに YOU を使わせるにはどうするかエージェントに you docs agents を実行して出力を読むよう伝えてください。このトピックは、インストール済みバイナリが内部に持つエージェント向けオリエンテーションとコマンド一覧です。そのためエージェントは、古くなりうる写しではなく、実際に手元にあるコマンドの全体像を学びます。あとはエージェントが CLI を直接使います。エージェントに YOU を使わせる方法 MCP や Cursor のダイナミックワークフローはどうつながるかホストが you mcp serve を起動すると、Factory Session のツールが you.factory_session.* という名前で現れます。Cursor は最初のダイナミックワークフローのループでこのブリッジを使います。MCP サーバーは stdio で通信し、独自の HTTP やダッシュボードのリスナーは起動しません。MCPMCP リファレンスダイナミックワークフローCursor ダイナミックワークフローガイド 正確なコマンドやスキーマはどこにあるかリファレンスページにあります。これらは書き写したものではなく、インストール済みの @you-agent-factory/api パッケージから投影されています。CLI リファレンスは公開されている全コマンド・フラグ・引数を、API リファレンスは同梱の OpenAPI ドキュメントそのものを、イベントリファレンスは全イベントコーパスとストリーム契約を扱います。CLI リファレンスAPI リファレンスイベントリファレンス 失敗したときはどこで復旧するかインストール、実行、設定、MCP、ダイナミックワークフローの手順が失敗したときは、トラブルシューティングを開いてください。症状ごとの復旧手順があり、担当する正式なドキュメントへリンクしています。よくある手順の質問にはこの FAQ を、失敗の症状がすでに分かっているときはトラブルシューティングを使ってください。トラブルシューティング
you-agent-factory とは何か。どこから始めるかyou-agent-factory は、長時間にわたるエージェントの作業を永続化し続ける CLI とワークフローシステムです。you という 1 つのバイナリとしてインストールされます。まず製品概要を読み、次にインストールしてパッケージ済みファクトリーを実行してから、CLI の詳細に進んでください。you-agent-factory とは最初のファクトリーを実行する you はどうやってインストールするかお使いのマシン向けの OS 別スクリプトでインストールし、シェルで you が解決できることを確認したうえで、ワーカーを実行するプロバイダーを設定します。コマンド一式はインストールページにあります。この FAQ では繰り返しません。インストール ファクトリーはどうやって実行するかyou init --package でパッケージ済みファクトリーをインストールし、you run --named に依頼を添えて名前で実行します。通常の実行はバッチモードで、HTTP リスナーを起動しません。そのため you session list が答えを返すのは、サーバー付きで実行を開始した場合か、you server が動いている場合だけです。最初のファクトリーを実行するCLIFactory Session バイナリにはどのファクトリーが同梱されているか組み込みカタログには 15 個のパッケージ済みファクトリーが含まれ、目標追跡、レビューループ、多数決とトーナメントによる比較、並列ファンアウト、計画立案、分類、ディープリサーチ、ファクトリーの自動作成、音声合成を網羅しています。各ファクトリーは自身の引数、既定値、実例を公開しています。パッケージ済みファクトリーリファレンスパッケージ済みファクトリー グラフファクトリーと JavaScript ファクトリーのどちらを書くべきかワークフローが作業の流れるトポロジーであり、項目ごとの永続的な状態と並行性を無料で得たい場合はグラフファクトリーを書きます。ワークフローが手続きであり、通常の制御構文を使いたい場合は JavaScript ファクトリーを書きます。orchestrator フィールドがエンジンを選び、省略するとグラフになります。最初のファクトリーを書くファクトリースキーマリファレンスJavaScript ランタイムリファレンス 設定はどこにあるかファクトリーごとのトポロジーは、ファクトリールート配下の factory.json にあります。ワーカーのプロバイダーなど運用者の既定値は ~/.you-agent-factory/config.json にあります。カタログからインストールした名前付きファクトリーは、別の場所を指定しない限り ~/.you-agent-factory/factories 配下に置かれます。設定グローバル設定ファクトリーシステム設定スキーマ AI エージェントに YOU を使わせるにはどうするかエージェントに you docs agents を実行して出力を読むよう伝えてください。このトピックは、インストール済みバイナリが内部に持つエージェント向けオリエンテーションとコマンド一覧です。そのためエージェントは、古くなりうる写しではなく、実際に手元にあるコマンドの全体像を学びます。あとはエージェントが CLI を直接使います。エージェントに YOU を使わせる方法 MCP や Cursor のダイナミックワークフローはどうつながるかホストが you mcp serve を起動すると、Factory Session のツールが you.factory_session.* という名前で現れます。Cursor は最初のダイナミックワークフローのループでこのブリッジを使います。MCP サーバーは stdio で通信し、独自の HTTP やダッシュボードのリスナーは起動しません。MCPMCP リファレンスダイナミックワークフローCursor ダイナミックワークフローガイド 正確なコマンドやスキーマはどこにあるかリファレンスページにあります。これらは書き写したものではなく、インストール済みの @you-agent-factory/api パッケージから投影されています。CLI リファレンスは公開されている全コマンド・フラグ・引数を、API リファレンスは同梱の OpenAPI ドキュメントそのものを、イベントリファレンスは全イベントコーパスとストリーム契約を扱います。CLI リファレンスAPI リファレンスイベントリファレンス 失敗したときはどこで復旧するかインストール、実行、設定、MCP、ダイナミックワークフローの手順が失敗したときは、トラブルシューティングを開いてください。症状ごとの復旧手順があり、担当する正式なドキュメントへリンクしています。よくある手順の質問にはこの FAQ を、失敗の症状がすでに分かっているときはトラブルシューティングを使ってください。トラブルシューティング