summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-02-22 13:32:21 +0200
committerPaul Buetow <paul@buetow.org>2026-02-22 13:32:21 +0200
commit8735394dae4266bea638b20b5d327ce366a608a1 (patch)
tree463483208ab6a16a98357403dfb3821702b7c68f
parent78d1b4a990148bc8f021958d0fe5af7769a49088 (diff)
docs: clarify Codex uses native Ctrl+G external editor
-rw-r--r--README.md1
-rw-r--r--config.toml.example2
-rw-r--r--docs/configuration.md1
-rw-r--r--docs/tmux.md2
-rw-r--r--docs/usage.md2
5 files changed, 8 insertions, 0 deletions
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):