summaryrefslogtreecommitdiff
path: root/docs/tmux.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-02-08 17:33:04 +0200
committerPaul Buetow <paul@buetow.org>2026-02-08 17:33:04 +0200
commit944838bb0f753a0920ddb2f506758c410ed7ca43 (patch)
tree12d6ae9e2de8878891159e363134a3f07686ed7a /docs/tmux.md
parentc802ba5803de1a53749bb5c4ecbc0159fceb385f (diff)
Fix amp agent prompt extraction to use TUI box pattern
Amp CLI runs in TUI mode with box-drawing UI (│ text │) similar to Cursor, not shell-style (> prompt). Updated prompt pattern from `(?m)>\s*(.+)$` to `(?m)│\s*(.+?)\s*│\s*$` to correctly extract text from amp's box UI. Changes: - internal/tmuxedit/config_agent.go: Update amp promptPat to box pattern - internal/tmuxedit/config_agent_test.go: Update test to use box format - docs/usage.md: Document detection order and clear methods for all agents - docs/tmux.md: Clarify input mode handling (Vim vs Emacs/readline) - config.toml.example: Add detailed agent descriptions and patterns - prompts/tmux-edit-integration-tests.md: Add test status, mock editor best practices Integration tests verified: - Amp detection: amp/sourcegraph keywords - Prompt extraction: "hello world test" correctly captured - End-to-end workflow: text modification and sending works - Multi-line support: all lines delivered correctly - All unit tests pass (67/67) - Coverage: 80.9% (meets requirement) - Cursor and Claude implementations unchanged Co-authored-by: Cursor <cursoragent@cursor.com>
Diffstat (limited to 'docs/tmux.md')
-rw-r--r--docs/tmux.md8
1 files changed, 7 insertions, 1 deletions
diff --git a/docs/tmux.md b/docs/tmux.md
index ae84ce2..1ece4c7 100644
--- a/docs/tmux.md
+++ b/docs/tmux.md
@@ -91,6 +91,12 @@ Then press `prefix + e` in any pane running an AI agent. Hexai auto-detects the
See the [configuration guide](configuration.md) for customizing popup dimensions and agent patterns, or the [usage guide](usage.md) for the full workflow description.
-**Vim mode recommended**: For best results, run both Cursor Agent and Claude Code in vim mode. Claude Code's `C-u` clear relies on readline/vim insert-mode behavior, and Cursor's prompt clearing works most reliably in its default input mode. The popup editor uses `$EDITOR` (or `$HEXAI_EDITOR`), so your normal vim/neovim setup is used for composing prompts.
+**Input mode notes**: Each agent uses different clearing methods based on their input handling:
+- **Claude Code**: Uses Vi/Vim keybindings (`Escape gg C-v G d i`), so vim mode is recommended
+- **Cursor**: Uses simple backspace clearing (`End BSpace*200`), works in default mode
+- **Amp**: Uses Emacs/readline keybindings (`C-u`), works in TUI mode
+- **Aider**: Uses Emacs/readline keybindings (`C-u`)
+
+The popup editor uses `$EDITOR` (or `$HEXAI_EDITOR`), so your normal vim/neovim setup is used for composing prompts.
**Note**: Agent detection and prompt extraction rely on regex patterns matched against each agent's terminal UI (box-drawing characters, prompt symbols, status text). When agents update their TUI layout, these patterns may need adjustment. You can override patterns per-agent in `[[tmux_edit.agents]]` config without code changes -- see the [configuration guide](configuration.md).