From 8735394dae4266bea638b20b5d327ce366a608a1 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sun, 22 Feb 2026 13:32:21 +0200 Subject: docs: clarify Codex uses native Ctrl+G external editor --- README.md | 1 + config.toml.example | 2 ++ docs/configuration.md | 1 + docs/tmux.md | 2 ++ docs/usage.md | 2 ++ 5 files changed, 8 insertions(+) diff --git a/README.md b/README.md index 2e92db2..75fb6e1 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,7 @@ It has got improved capabilities for Go code understanding (for example, create * Tmux popup editor (`hexai-tmux-edit`) for composing longer AI agent prompts - Opens `$EDITOR` in a tmux popup, pre-filled with the current prompt text - Auto-detects Claude Code, Cursor, Amp, Aider (WIP), and other agents + - OpenAI Codex CLI already has native external-editor support via `Ctrl+G` - Config-driven: add new agents via `[tmux_edit]` in config.toml * Support for OpenAI, OpenRouter, Anthropic, and Ollama diff --git a/config.toml.example b/config.toml.example index d23f738..84734a5 100644 --- a/config.toml.example +++ b/config.toml.example @@ -161,6 +161,8 @@ temperature = 0.2 # Override or add agent definitions (merged with built-in defaults by name). # Built-in agents (checked in order): cursor, claude, amp, aider. +# OpenAI Codex CLI already supports external editor mode via Ctrl+G, +# so no built-in codex tmux_edit agent profile is needed. # - cursor: Box UI │...│, clears with End+BSpace*200 # - claude: Prompt symbol ❯, clears with C-a C-k (Emacs/readline) # - amp: Box UI │...│ (TUI mode), clears with C-u (Emacs/readline) diff --git a/docs/configuration.md b/docs/configuration.md index 939b001..013d2c8 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -141,4 +141,5 @@ Hexai Tmux Edit (popup editor) ``` - Built-in agents: `claude`, `cursor`, `amp`, `aider`. See [config.toml.example](../config.toml.example) for all fields. +- OpenAI Codex CLI uses its native external editor shortcut (`Ctrl+G`) instead of a built-in `tmux_edit` agent profile. - Tmux keybinding: `bind e run-shell -b "cd '#{pane_current_path}' && hexai-tmux-edit --pane '#{pane_id}'"` diff --git a/docs/tmux.md b/docs/tmux.md index b851296..a1628cb 100644 --- a/docs/tmux.md +++ b/docs/tmux.md @@ -73,6 +73,8 @@ window_minutes = 60 # default 60; min 1, max 1440 `hexai-tmux-edit` opens your `$EDITOR` in a tmux popup to compose longer prompts when working with AI CLI agents (Claude Code, Cursor, Amp, Aider, etc.). +OpenAI Codex CLI already supports editing in an external editor via `Ctrl+G`, so it does not need a built-in `hexai-tmux-edit` agent profile. + ![Popup editor in action](tmux-edit-popup.png) The editor opens as a tmux popup overlay, pre-filled with any existing prompt text from the agent's input. After saving and closing, the text is sent back: diff --git a/docs/usage.md b/docs/usage.md index f5d977b..f4f4850 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -157,6 +157,8 @@ Tips: This is useful when working with AI CLI agents (Claude Code, Cursor, Amp, Aider, etc.) and you need to compose a longer, multi-line prompt with the comfort of your regular editor (spellcheck, search/replace, etc.). +OpenAI Codex CLI is not a built-in `hexai-tmux-edit` agent. Codex already supports editing in an external editor via `Ctrl+G`. + ### Supported agents Built-in agent detection (auto-detected from pane content, checked in order): -- cgit v1.2.3