summaryrefslogtreecommitdiff
path: root/docs/tmux.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-02-08 11:16:46 +0200
committerPaul Buetow <paul@buetow.org>2026-02-08 11:16:46 +0200
commit3698679c27896d0e77f677a769c7ac1437f7e042 (patch)
treefd9bc755901188ed9bfef9b0665f7312f0f67a6b /docs/tmux.md
parent5e825543dc55a2c649e68dce6341844ad71fa217 (diff)
add hexai-tmux-edit documentation to all doc files
Update README, build guide, configuration guide, usage guide, and tmux guide with hexai-tmux-edit popup editor documentation including supported agents, keybinding setup, flags, workflow, and configuration examples. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Diffstat (limited to 'docs/tmux.md')
-rw-r--r--docs/tmux.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/tmux.md b/docs/tmux.md
index a5e397c..250903e 100644
--- a/docs/tmux.md
+++ b/docs/tmux.md
@@ -68,3 +68,17 @@ window_minutes = 60 # default 60; min 1, max 1440
```
- The tmux status shows the window as `Σ@1h` or `Σ@45m`.
+
+## Popup editor for AI agent prompts
+
+`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.).
+
+Add this keybinding to `~/.tmux.conf`:
+
+```
+bind e run-shell -b "hexai-tmux-edit --pane '#{pane_id}'"
+```
+
+Then press `prefix + e` in any pane running an AI agent. Hexai auto-detects the agent, extracts any existing prompt text, and pre-fills the editor. After saving and closing, the edited text is sent back to the agent's pane.
+
+See the [configuration guide](configuration.md) for customizing popup dimensions and agent patterns, or the [usage guide](usage.md) for the full workflow description.