From a1031b761ff0c5cd79f3f0906e5c3b33fa849f37 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Sat, 25 Apr 2026 16:12:23 +0300
Subject: feat: configurable hexai-tmux-action menu via [[tmux_action.menu]]

When [[tmux_action.menu]] is defined in config it fully replaces the
built-in menu. Each entry takes a kind (built-in or "custom"), optional
title/hotkey overrides, and optional custom_id for embedding custom
actions directly in the main menu. Hotkey dispatch is now dynamic so
any single-character hotkey works without code changes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 config.toml.example | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

(limited to 'config.toml.example')

diff --git a/config.toml.example b/config.toml.example
index 1bed067..80253fc 100644
--- a/config.toml.example
+++ b/config.toml.example
@@ -148,6 +148,39 @@ temperature = 0.2
 [tmux]
 # custom_menu_hotkey = "a"            # hotkey to open the custom actions submenu in hexai-tmux-action
 
+# hexai-tmux-action menu configuration (optional).
+# When [[tmux_action.menu]] is defined it completely replaces the built-in menu.
+# Valid built-in kinds: rewrite, simplify, document, gotest, fix_typos, custom_prompt, skip.
+# Use kind = "custom" with custom_id referencing a [[prompts.code_action.custom]] id
+# to embed a custom action directly in the main menu instead of the submenu.
+# title and hotkey are optional; built-in defaults are used when omitted.
+#
+# [[tmux_action.menu]]
+# kind   = "rewrite"
+# hotkey = "r"
+#
+# [[tmux_action.menu]]
+# kind   = "simplify"
+# hotkey = "i"
+#
+# [[tmux_action.menu]]
+# kind   = "fix_typos"
+# hotkey = "f"
+#
+# [[tmux_action.menu]]
+# kind      = "custom"
+# custom_id = "extract-function"   # must match id in [[prompts.code_action.custom]]
+# hotkey    = "e"
+# title     = "Extract function"   # optional override
+#
+# [[tmux_action.menu]]
+# kind   = "custom_prompt"
+# hotkey = "p"
+#
+# [[tmux_action.menu]]
+# kind   = "skip"
+# hotkey = "s"
+
 [stats]
 # window_minutes = 60                  # sliding window for global stats (Σ@window); min 1, max 1440
 
-- 
cgit v1.2.3