Settable ttimeoutlen for Escape key sequences

changelog.md

@@ -1,3 +1,11 @@
+Upcoming (TBD)
+==============
+
+Features
+---------
+* Allow shorter timeout lengths after pressing Esc, for vi-mode.
+
+
 1.60.0 (2026/03/05)
 ==============
 

mycli/key_bindings.py

@@ -103,9 +103,11 @@ def _(event: KeyPressEvent) -> None:
         if mycli.key_bindings == "vi":
             event.app.editing_mode = EditingMode.EMACS
             mycli.key_bindings = "emacs"
+            event.app.ttimeoutlen = mycli.emacs_ttimeoutlen
         else:
             event.app.editing_mode = EditingMode.VI
             mycli.key_bindings = "vi"
+            event.app.ttimeoutlen = mycli.vi_ttimeoutlen
 
     @kb.add('escape', '[', 'S')
     def _(event: KeyPressEvent) -> None:
@@ -114,9 +116,11 @@ def _(event: KeyPressEvent) -> None:
         if mycli.key_bindings == 'vi':
             event.app.editing_mode = EditingMode.EMACS
             mycli.key_bindings = 'emacs'
+            event.app.ttimeoutlen = mycli.emacs_ttimeoutlen
         else:
             event.app.editing_mode = EditingMode.VI
             mycli.key_bindings = 'vi'
+            event.app.ttimeoutlen = mycli.vi_ttimeoutlen
 
     @kb.add("tab")
     def _(event: KeyPressEvent) -> None:

mycli/main.py

@@ -198,6 +198,8 @@ def __init__(
         self.config_without_user_options = read_config_files(config_files, ignore_user_options=True)
         self.multi_line = c["main"].as_bool("multi_line")
         self.key_bindings = c["main"]["key_bindings"]
+        self.emacs_ttimeoutlen = c['keys'].as_float('emacs_ttimeoutlen')
+        self.vi_ttimeoutlen = c['keys'].as_float('vi_ttimeoutlen')
         special.set_timing_enabled(c["main"].as_bool("timing"))
         special.set_show_favorite_query(c["main"].as_bool("show_favorite_query"))
         self.beep_after_seconds = float(c["main"]["beep_after_seconds"] or 0)
@@ -1311,6 +1313,11 @@ def one_iteration(text: str | None = None) -> None:
                 search_ignore_case=True,
             )
 
+            if self.key_bindings == 'vi':
+                self.prompt_app.app.ttimeoutlen = self.vi_ttimeoutlen
+            else:
+                self.prompt_app.app.ttimeoutlen = self.emacs_ttimeoutlen
+
         try:
             while True:
                 one_iteration()

mycli/myclirc

@@ -235,6 +235,14 @@ control_d = exit
 # possible values: auto, fzf, reverse_isearch
 control_r = auto
 
+# How long to wait for an Escape key sequence in vi mode.
+# 0.5 seconds is the prompt_toolkit default, but vi users may find that too long.
+# Shorter values mean that "Escape" alone is recognized more quickly.
+vi_ttimeoutlen = 0.1
+
+# How long to wait for an Escape key sequence in Emacs mode.
+emacs_ttimeoutlen = 0.5
+
 # Custom colors for the completion menu, toolbar, etc, with actual support
 # depending on the terminal, and the property being set.
 # Colors: #ffffff, bg:#ffffff, border:#ffffff.

test/myclirc

@@ -233,6 +233,14 @@ control_d = exit
 # possible values: auto, fzf, reverse_isearch
 control_r = auto
 
+# How long to wait for an Escape key sequence in vi mode.
+# 0.5 seconds is the prompt_toolkit default, but vi users may find that too long.
+# Shorter values mean that "Escape" alone is recognized more quickly.
+vi_ttimeoutlen = 0.1
+
+# How long to wait for an Escape key sequence in Emacs mode.
+emacs_ttimeoutlen = 0.5
+
 # Custom colors for the completion menu, toolbar, etc, with actual support
 # depending on the terminal, and the property being set.
 # Colors: #ffffff, bg:#ffffff, border:#ffffff.