Skip to content

README.ja.md

Latest commit

 

History

History
114 lines (72 loc) · 6.4 KB

README.ja.md

File metadata and controls

114 lines (72 loc) · 6.4 KB
Raw

ChatGPT Codex Tools

中文 English 日本語 한국어

ChatGPT Codex Tools は、ChatGPT デスクトップアプリ内の Codex 起動、接続モード、UI 拡張、スクリプト、診断、修復をまとめて扱う独立型の Go + React デスクトップマネージャーです。 タスク中心の管理 UI、Relay と Provider 設定、スクリプト管理、ローカル修復、デスクトップ配布、サポート用診断を、単独でビルドできるリポジトリにまとめています。

含まれるもの

  • ローカルコマンド、静的 UI 配信、デスクトップ起動体験を担う Go バックエンド。
  • 非技術ユーザー向けに整理した React 管理 UI。
  • 初回セットアップ、起動状態、接続モード選択、Relay 設定、会話修復、スクリプト、ログ、診断、メンテナンスツール。
  • このリポジトリから公開される macOS / Windows デスクトップパッケージ。

画面

ホームダッシュボード

起動状態、接続モード、UI 拡張モード、修復入口を表示する ChatGPT Codex Tools ホームダッシュボード

最初の画面でローカル環境の準備状態を確認し、主要な起動ボタン、接続サービス、UI 機能、修復入口、重要な状態をまとめて扱えます。

初回セットアップガイド

システム検出、ChatGPT インストール状態、CCSwitch インポート、モード選択、起動手順を表示する ChatGPT Codex Tools 初回ガイド

システム確認、ChatGPT インストール検出、CCSwitch Provider のインポート、接続モード選択、起動までを順番に進めます。

よくある質問

この内容は現在の ChatGPT Codex Tools 向けに整理したものです。

ChatGPT Codex Tools メニューが表示されない

ChatGPT Codex 入口から ChatGPT を起動していることを確認してください。管理ツールの「診断」と「ログ」ページで注入状態を確認することもできます。

プラグイン内でバックエンドに接続できないと表示される

まずブラウザまたは PowerShell で確認します。

Invoke-RestMethod -Method Post -Uri http://127.0.0.1:57321/backend/status -Body "{}" -ContentType "application/json"

API が正常でもプラグインがタイムアウトする場合、ChatGPT ページ内の CDP bridge またはスクリプトキャッシュが原因であることが多いです。ChatGPT Codex から ChatGPT を再起動するか、管理ツールのログで renderer.script_loaded、bridge.request、bridge.response を確認してください。

Upstream worktree と Codex 標準の worktree 作成の違い

ChatGPT Codex Tools の Upstream worktree は、先にリモートブランチを更新してから次のコマンドを実行する動作に相当します。

git worktree add -b <new-branch> <worktree-path> upstream/<base-branch>

そのため、新しい worktree は現在のセッションのローカル HEAD ではなく、最新のリモート追跡ブランチから開始されます。現在の ChatGPT Codex バージョンの標準 worktree 作成フォームを安全に識別できない場合は、ChatGPT Codex Tools メニューからリポジトリパス、ブランチ名、worktree パス、remote、base branch を手動で入力してください。

macOS で開けない、または壊れていると表示される

パッケージが未署名または未公証の場合、macOS Gatekeeper が .pkg インストーラーまたはインストール後の App をブロックし、壊れていると表示することがあります。

ChatGPT Codex 管理ツールが壊れていると表示する macOS 警告

次のコマンドで隔離属性を削除してください。

sudo xattr -rd com.apple.quarantine ~/Downloads/ChatGPT-Codex-Tools-*-macos-*.pkg
sudo xattr -rd com.apple.quarantine "/Applications/ChatGPT Codex 管理工具.app"
sudo xattr -rd com.apple.quarantine "/Applications/ChatGPT Codex.app"

インストール時にブロックされる場合は、ダウンロードした .pkg に対して最初のコマンドを実行してから再インストールしてください。インストール後の起動時にブロックされる場合は、/Applications 内の 2 つの App に対して後半 2 つのコマンドを実行し、ChatGPT Codex または ChatGPT Codex 管理工具 を再度開いてください。

macOS Intel でも使えますか

使えます。Release では macos-x64 と macos-arm64 のパッケージを分けて提供します。Intel Mac は x64、Apple Silicon は arm64 パッケージを使ってください。

ローカル開発

npm --prefix web install
npm --prefix web run vite:build
go run .

ビルド

npm --prefix web run check
npm --prefix web run vite:build
go build -o codextools .

ダウンロード

  • ダウンロードページ: docs/downloads.html
  • Windows は x64 と arm64 のインストーラーを提供し、両方のポータブル zip も残しています。
  • macOS は Apple Silicon (macos-arm64) と Intel (macos-x64) のパッケージを提供します。

コミュニティ

由来と謝辞

ChatGPT Codex Tools は、Codex を内蔵した現在の ChatGPT デスクトップアプリ向けの独立した Go リファクタリングと管理 UI プロジェクトです。 基礎機能、ワークフローの考え方、ユーザー向けツールの方向性を作った初期コミュニティの取り組みに感謝します。