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

you-agent-factory の you CLI をインストールし、PATH で解決できることを確認し、ワーカーのプロバイダーを選び、組み込みカタログからパッケージ済みファクトリーをインストールします。

インストール

公開されているリリース用エントリポイントが、お使いの OS 向けの you バイナリをダウンロードし、PATH に配置します。ここで行われるのは CLI のインストールだけで、ファクトリーの起動も設定ファイルの書き込みも行いません。

macOS / Linux

curl -fsSL https://github.com/portpowered/you-agent-factory/releases/latest/download/install.sh | sh

Windows (PowerShell)

irm https://github.com/portpowered/you-agent-factory/releases/latest/download/install.ps1 | iex

インストーラーはバイナリを書き込み、新しいシェル向けに PATH を更新します。you を初めて実行する前に、新しいターミナルを開くかシェルのプロファイルを再読み込みしてください。

インストールの確認

ルートのヘルプを表示して、シェルが you を解決できることと、トップレベルのコマンドグループを確認します。

you -h

バイナリ自体もオフラインで読めるリファレンストピックを内蔵しています。索引を表示すると、ネットワーク接続なしで読めるトピックが一覧できます。

you docs

プロバイダーを選ぶ

ワーカーのプロバイダーとは、実際に作業を実行するエージェントまたはモデルのランタイム、つまり各ワーカーの背後にあるコーディングエージェントや推論バックエンドです。you init は既定のプロバイダーと任意の既定モデルを記録するため、ファクトリー側で指定する必要がなくなります。フラグなしで実行すると対話的に尋ねられ、--provider を渡せばスクリプトや CI ジョブから非対話的に設定できます。

対話的にプロバイダーを設定する

you init

非対話的にプロバイダーを設定する

you init --provider codex

プロバイダー名はこのドキュメントで固定されているわけではありません。運用者が追加した Agent Client Protocol プロバイダーも含めて、選択可能なものはバイナリが報告します。

you workers list

パッケージ済みファクトリーをインストールする

パッケージ済みファクトリーは、バイナリに同梱された完成済みのワークフローです。インストールすると定義が名前付きファクトリールートへコピーされ、実行・閲覧・編集ができるようになります。

you init --package @you/goal

既定では、パッケージ済みファクトリーはホームディレクトリ配下のグローバルな名前付きファクトリールートにインストールされます。プロジェクト内のルートに入れるには --dir、ルート定義の記述形式を選ぶには --format、既存のディレクトリを上書きするには --replace を渡します。一覧表示は一度に 1 つのルートだけを読み、2 つを統合することはありません。--package でインストールしたものを見るには --dir でグローバルルートを指してください。

you factory list --dir ~/.you-agent-factory/factories

パッケージ済みファクトリーリファレンス — 同梱ファクトリーとそのソース

保存先

プロバイダーの既定値は運用者の設定であり、~/.you-agent-factory/config.json に保存されます。--package でインストールした名前付きファクトリーは、--dir で別の場所を指定しない限り ~/.you-agent-factory/factories 配下に置かれます。プロジェクト用に自分で書いたファクトリーは、そのプロジェクトの隣、./factory/factory.json に置きます。

よくある落とし穴

インストール後に最も多い失敗はプロバイダー未設定です。ワーカーがディスパッチされてもランタイムが見つからず、実行がすぐ終了します。最初の実行の前にプロバイダーを設定してください。次に多いのは、PATH をすでに読み込み済みのシェルでインストーラーが完了した場合です。インストールが失敗したと判断する前に、新しいターミナルを開いてください。

次のステップ

プロバイダーを設定し、パッケージ済みファクトリーをインストールしたら、次に最も役立つのは実際に 1 つを最後まで実行してみることです。