From 04b6ecadc4a5efacb573cdeded06fa9642a1a71b Mon Sep 17 00:00:00 2001
From: StefanIsMe <130151819+StefanIsMe@users.noreply.github.com>
Date: Thu, 19 Mar 2026 20:50:25 +0700
Subject: [PATCH] feat(cli): Tab now accepts auto-suggestions (ghost text)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Previously, Tab only handled dropdown completions. Users seeing gray
ghost text from history-based suggestions had no way to accept them
with Tab - they had to use Right arrow or Ctrl+E.

Now Tab follows priority:
1. Completion menu open → accept selected completion
2. Ghost text suggestion available → accept auto-suggestion
3. Otherwise → start completion menu

This matches user intuition that Tab should 'complete what I see.'
---
 cli.py                         | 13 +++++++++++--
 website/docs/user-guide/cli.md |  2 +-
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/cli.py b/cli.py
index 86076c780..a4b8c4b33 100755
--- a/cli.py
+++ b/cli.py
@@ -5887,7 +5887,12 @@ class HermesCLI:
 
         @kb.add('tab', eager=True)
         def handle_tab(event):
-            """Tab: accept completion and re-trigger if we just completed a provider.
+            """Tab: accept completion, auto-suggestion, or start completions.
+
+            Priority:
+            1. Completion menu open → accept selected completion
+            2. Ghost text suggestion available → accept auto-suggestion
+            3. Otherwise → start completion menu
 
             After accepting a provider like 'anthropic:', the completion menu
             closes and complete_while_typing doesn't fire (no keystroke).
@@ -5896,6 +5901,7 @@ class HermesCLI:
             """
             buf = event.current_buffer
             if buf.complete_state:
+                # Completion menu is open — accept the selection
                 completion = buf.complete_state.current_completion
                 if completion is None:
                     # Menu open but nothing selected — select first then grab it
@@ -5909,8 +5915,11 @@ class HermesCLI:
                 text = buf.document.text_before_cursor
                 if text.startswith("/model ") and text.endswith(":"):
                     buf.start_completion()
+            elif buf.suggestion and buf.suggestion.text:
+                # No completion menu, but there's a ghost text auto-suggestion — accept it
+                buf.insert_text(buf.suggestion.text)
             else:
-                # No menu open — start completions from scratch
+                # No menu and no suggestion — start completions from scratch
                 buf.start_completion()
 
         # --- Clarify tool: arrow-key navigation for multiple-choice questions ---
diff --git a/website/docs/user-guide/cli.md b/website/docs/user-guide/cli.md
index a33ed295e..9c16ca831 100644
--- a/website/docs/user-guide/cli.md
+++ b/website/docs/user-guide/cli.md
@@ -94,7 +94,7 @@ When resuming a previous session (`hermes -c` or `hermes --resume <id>`), a "Pre
 | `Ctrl+B` | Start/stop voice recording when voice mode is enabled (`voice.record_key`, default: `ctrl+b`) |
 | `Ctrl+C` | Interrupt agent (double-press within 2s to force exit) |
 | `Ctrl+D` | Exit |
-| `Tab` | Autocomplete slash commands |
+| `Tab` | Accept auto-suggestion (ghost text) or autocomplete slash commands |
 
 ## Slash Commands