For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション
Theme

ローカル環境

プロジェクトでよく使うアクションと Worktree のセットアップスクリプトを設定する方法

ローカル環境では、Worktree のセットアップ手順と、プロジェクトでよく使うアクションを設定できます。

ローカル環境を利用できるのは、ChatGPT デスクトップアプリの Codex のみです。 ローカル環境を設定または使用する前に、Codex を選択してください。

ローカル環境は、ChatGPT デスクトップアプリの設定画面で設定します。生成されたファイルをプロジェクトの Git リポジトリにコミットすると、他のユーザーと設定を共有できます。

Codex は、この設定をプロジェクトのルートにある .codex フォルダに保存します。リポジトリに複数のプロジェクトがある場合は、共有の .codex フォルダがあるプロジェクトディレクトリを開いてください。

セットアップスクリプト

Worktree での作業には、ローカルのチャットとは別のディレクトリを使います。そのため、プロジェクトのセットアップが完了しておらず、依存関係や、リポジトリにコミットしていないファイルが不足していることがあります。新しいチャットの開始時に Codex が Worktree を作成すると、セットアップスクリプトが自動的に実行されます。

このスクリプトには、依存関係のインストールやビルドなど、環境のセットアップに必要なコマンドを記述します。

たとえば、TypeScript プロジェクトでは、次のセットアップスクリプトで依存関係をインストールし、初回のビルドを実行できます。

npm install
npm run build

セットアップ手順がプラットフォームによって異なる場合は、macOS、Windows、Linux のうち、対象の環境に合わせたセットアップスクリプトを定義して、デフォルトのスクリプトを上書きできます。

アクション

アプリの開発サーバーの起動やテストスイートの実行など、よく行うタスクをアクションとして定義できます。アクションは ChatGPT デスクトップアプリ上部のバーに表示され、そこからすぐに実行できます。実行にはアプリの統合ターミナルが使われます。

プロジェクトのビルドや開発サーバーの起動をアクションにしておくと、その都度コマンドを入力する手間が省けます。一度だけ手早くデバッグしたい場合は、統合ターミナルを直接使えます。

たとえば、Node.js プロジェクトでは、次のスクリプトを使って「実行」というアクションを作成できます。

npm start

アクションで使うコマンドがプラットフォームによって異なる場合は、macOS、Windows、Linux それぞれに対応するスクリプトを定義します。

アクションを見分けやすくするには、それぞれの操作に合ったアイコンを選びます。

組み込みの Git ツール

ChatGPT デスクトップアプリの Codex では、各ローカルプロジェクトや Worktree の横に、よく使う Git 操作が表示されます。差分ペインでは、現在のチェックアウトの変更内容を確認し、Codex に対応してほしい箇所にインラインコメントを追加できます。変更を個々の差分ブロック単位またはファイル単位でステージしたり、元に戻したりできます。変更のコミット、ブランチのプッシュ、pull request の作成もアプリ内で行えます。

アプリの画面から行えない Git 操作には、統合ターミナルを使います。並行作業での変更をローカルのチェックアウトから切り離すには、Worktree でタスクを開始します。