推奨セットアップ: LaunchRepoで最良の結果を得るには、ClaudeやCodexのデスクトップアプリではなく、ターミナルでClaude Code CLIまたはCodex CLIを使うことを強くおすすめします。これは推奨するワークフローであり、異なる権限や中断のない実行を保証するものではありません。
キット自体のスタートページは1画面に収まります。クローンして、プロンプトを1つ貼り付け、リンクを開くだけです。このガイドでは同じ3つのステップを、それぞれの裏で何が起きているのかを少し補足しながら説明します。エージェントが何をしているのか、そして終わったときに何を確認すればよいのかがわかるはずです。先に全体像を知りたい場合は、仕組みのページで、これらのステップがプロダクト → エージェント → ディレクトリ → トラッカーという全体の流れのどこに位置するかを確認できます。
始める前に必要なもの
初期セットアップには、次のものが必要です。
- Git:リポジトリのクローンに使います。
- Python 3.10以降:Windows、macOS、Linuxのいずれでも構いません。ワークスペースのスクリプト、トラッカー、ローカルダッシュボードは標準ライブラリだけで書かれたPythonなので、
pip installするものも、ビルドの手順もありません。 - ファイルを読み、コマンドを実行できるコーディングエージェント:Claude Code、Codex、Cursor、またはそれに相当するツールです。このサイトには、それぞれのセットアップページがあります。たとえばClaude Code、Codex、Cursorです。ブラウザの操作は後の段階で必要になるもので、最初の3ステップでは不要です。
リポジトリそのものは、購入時に指定したアカウント宛てのGitHubの招待として届きます。以下の手順は、その招待を承諾済みであることを前提としています。
ステップ1:クローンして開く
Windowsでは、以下のコマンドのpython3の代わりにpy -3を使ってください(Python 3.10以降のコマンドがpythonの場合はそちらを使います)。ワークスペースは、OneDriveなどの同期フォルダの外にある、プライベートなローカルフォルダに置いてください。
git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo
普段プロジェクトを開くのと同じ方法で、そのフォルダをエージェントで開きます。この時点では、まだ何も実行されません。いまクローンしたのは配布用リポジトリで、プレイブック、テンプレート、スクリプト、ドキュメントが入っています。あなたのプロダクト、認証情報、申請記録はここには置きません。それこそがステップ2の目的です。
ステップ2:スタート用プロンプトを貼り付ける
次のテキストを、そのままエージェントに貼り付けてください。
Read AGENTS.md, then follow “Start the dashboard for the owner”. Create my private workspace if I do not have one yet, start the dashboard, and give me the link.
AGENTS.mdは、すべてのAIコーディングエージェントが最初に読むファイルです。正確な開始手順と、エージェントが行うべきチェックが書かれています。これに従って、エージェントは次のことを行います。
scripts/init-workspace.pyを使って、チェックアウトの隣にプライベートワークスペース(デフォルトでは同じ階層のフォルダ)を作成します。これにより、プロダクトのデータが共有の配布用リポジトリに置かれることはありません。- そのワークスペースの中からローカルダッシュボードを起動します。
127.0.0.1のリンクを返します。
エージェントがリンクを返してきたら、ステップ2は成功です。何をするつもりかの説明が返ってきた場合は、実際に手順を実行するよう依頼してください。キットのルールでは、チェックは手順が存在した時点ではなく、実際に確認できた時点で初めて完了とみなされます。
ステップ3:リンクを開く
最初のセッションの残りは、ダッシュボードのタブで進めます。そこから最初のプロダクトを追加し、オンボーディング用のプロンプトをエージェントに渡し、どの掲載が公開中、審査待ち、予約済み、あなたの対応待ちなのかを確認し、今後のラン用のプロンプトをコピーします。ダッシュボードは127.0.0.1にのみバインドし、ディレクトリには一切接続しません。各画面についてはローカルダッシュボードのガイドで説明しています。
作業が終わったら、エージェントのターミナルでCtrl+Cを押すか、エージェントにサーバーの停止を頼んでください。ワークスペースと、そこに記録されたものはすべてディスクに残ります。
手作業で進める
セットアップ自体には、エージェントは必要ありません。プロンプトによって実行されるのと同じ3つのコマンドは、次のとおりです。
python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py
ワークスペースを作る前に、まず様子を見てみたいですか? python3 scripts/dashboard.py --demoを実行すると、架空のプロダクトが入った使い捨てのサンプルワークスペースが起動します。自分のデータに触れることなく、概要画面、プロダクトページ、カタログをクリックして見て回れます。
次のステップ
本格的な最初のセッション(プロダクトブリーフ、ブラウザの接続、権限、保存されたランの目標)はエージェントが主導します。詳しくは最初のセッションのオンボーディングガイドを参照してください。エージェントがフォームに入力できるようにするには、エージェントをChromeに接続する必要もあります。先に読み物として流れをつかみたい場合は、Claude Codeのウォークスルーで1つのローンチを最初から最後まで追えます。オンボーディングが終わったら、ローンチランを最初から最後までで、権限の確認から残りのプラットフォームの再開まで、以降のランがどのように進むかを確認できます。