autohandai · igorcosta · Sep 11, 2026 · Sep 10, 2026 · Sep 11, 2026 · Sep 11, 2026
diff --git a/docs/config-reference.md b/docs/config-reference.md
@@ -730,6 +730,7 @@ See [Workspace Safety](./workspace-safety.md) for full details.
 | `showCompletionNotification` | boolean | `true`  | Show system notification when task completes                                                   |
 | `showThinking`               | boolean | `true`  | Display LLM's reasoning/thought process                                                        |
 | `mouseComposerCursor`        | boolean | on, except iTerm2 | Enable click-to-position editing in the Ink composer                                           |
+| `keybindingProfile`          | string | `"autohand"` | Shortcut profile for the composer: `autohand`, `claude-code`, `codex`, `cursor`, `antigravity`, `devin` or `factory`. See [Keyboard Shortcut Profiles](#keyboard-shortcut-profiles) |
 | `terminalBell`               | boolean | `true`  | Ring terminal bell when task completes (shows badge on terminal tab/dock)                      |
 | `checkForUpdates`            | boolean | `true`  | Check for CLI updates on startup                                                               |
 | `updateCheckInterval`        | number | `24`    | Hours between update checks (uses cached result within interval)                               |
@@ -854,7 +855,7 @@ Customize the verbs in the config file when you want a fixed status label or a s
 }
 ```
 
-`activityVerbs` accepts either a single string or a non-empty string array. When `activityVerbsEnabled` is `false`, Autohand falls back to `Working...` instead of rotating through custom or built-in verbs.
+`activityVerbs` accepts either a single string or a non-empty string array. When `activityVerbsEnabled` is `false`, Autohand falls back to `Working...` instead of rotating through custom or built-in verbs. While the agent works, a rotating tip line also appears under the status line with shortcuts, slash commands, sub-agent hints and your installed skills; it disappears when the turn ends.
 
 You can toggle completion reports, including the structured `SITREP` prompt, without editing the file:
 
@@ -920,6 +921,62 @@ autohand config set ui.mouseComposerCursor false
 
 Terminal mouse reporting can change native selection and scroll-wheel behavior. During active work, click a live command to expand or compact its output; clicks in the composer continue to position its cursor. Mouse reporting is always restored when Autohand exits. Terminal-specific modifier keys, commonly Shift, may bypass mouse reporting for native selection.
 
+### Keyboard Shortcut Profiles
+
+If you already use another coding agent, the composer can follow its shortcuts.
+Pick a profile during setup (offered when Autohand detects the agent on your
+machine), in `/settings` → UI → Keyboard shortcuts, or directly:
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+Every profile keeps Autohand's fixed keys: Enter submits, Esc interrupts,
+Shift+Tab cycles interaction modes, Ctrl+C clears the input and exits on a
+second press, `?` on an empty composer shows the shortcuts panel, and Ctrl+O,
+Ctrl+T and Ctrl+G expand command output and toggle the team and goals panels.
+Profiles add what the other agent binds on top:
+
+| Profile       | Newline                              | Exit                | History                 |
+| ------------- | ------------------------------------ | ------------------- | ----------------------- |
+| `autohand`    | Shift+Enter, Alt+Enter               | Ctrl+C twice        | `/whatityped`           |
+| `claude-code` | Shift+Enter, Alt+Enter, Ctrl+J       | Ctrl+D              | Ctrl+R                  |
+| `codex`       | Shift+Enter, Alt+Enter, Ctrl+J       | Ctrl+D              | Ctrl+R                  |
+| `cursor`      | Shift+Enter, Alt+Enter, Ctrl+J       | Ctrl+D              | `/whatityped`           |
+| `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J       | Ctrl+D              | `/whatityped`           |
+| `devin`       | Shift+Enter, Alt+Enter, Ctrl+J       | Ctrl+D              | Ctrl+R                  |
+| `factory`     | Shift+Enter, Alt+Enter               | Ctrl+C twice        | `/whatityped`           |
+
+Ctrl+D exits only when the composer is empty. Ctrl+R opens the same history
+view as `/whatityped`. The `?` panel always lists the chords of the active
+profile, so it is the quickest way to check what is bound.
+
+Two agents let you remap their own shortcuts in a file, and Autohand honours
+those remaps for the actions it shares. With `claude-code`, bindings in
+`~/.claude/keybindings.json` for `chat:newline`, `chat:cycleMode`, `app:exit`,
+`app:toggleTranscript`, `app:toggleTodos` and `history:search` are applied,
+including `null` to unbind. With `codex`, `insert_newline` and
+`history_search` under `[tui.keymap.composer]` and `exit` under
+`[tui.keymap.global]` in `~/.codex/config.toml` replace the profile's chords.
+Chords with more than one keystroke are ignored, and a malformed file leaves
+the profile defaults in place. Extension keybindings can never take a chord
+that the active profile uses.
+
+Which chords actually arrive depends on the terminal, not on the profile:
+
+- **Shift+Enter** needs a terminal that encodes modified keys through the kitty
+  keyboard protocol, which Autohand requests at start: Ghostty, kitty, WezTerm
+  and iTerm2 3.5 or later do; Terminal.app does not.
+- **Alt+Enter** needs Option configured as Meta in macOS terminals.
+- **Ctrl+J** is a plain control byte and works on any tty, including tmux,
+  which is why every non-default profile includes it.
+
+**Import during setup.** When setup detects Claude Code, Codex, Cursor, Gemini,
+Cline, Continue, Augment, OpenCode, Kimi or Grok, it also offers to bring your
+memories, sessions and skills across. Accepting runs the same import as
+`autohand import --all --categories memory,sessions,skills`; you can decline
+and run `/import` later, and a failed import never blocks setup.
+
 ### Update Check
 
 When `checkForUpdates` is enabled (default), Autohand checks for new releases on startup:
@@ -2595,6 +2652,7 @@ The picker loads twenty sessions per page and provides **More sessions** and **P
 | `/share`      | Share current session                                 |
 | `/status`     | Show session status and the signed-in Autohand plan   |
 | `/usage`      | Show Autohand plan limits and project token activity  |
+| `/upgrade`    | Open the console to upgrade your Autohand plan        |
 
 `/undo` never resets or cleans the Git worktree. It preserves unrelated tracked and untracked work, and refuses to overwrite a file that changed after the recorded agent mutation.
 

diff --git a/docs/config-reference_cs.md b/docs/config-reference_cs.md
@@ -704,6 +704,29 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 ```
 ---
 
+### Profily klávesových zkratek
+
+Pokud už používáte jiného kódovacího agenta, skladatel může sledovat jeho zkratky. Profil vyberete při nastavení (nabídne se, když Autohand agenta najde), v `/settings` → UI → Klávesové zkratky, nebo příkazem:
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+| Profil | Nový řádek | Ukončení | Historie |
+| --- | --- | --- | --- |
+| `autohand` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+| `claude-code`, `codex`, `devin` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | Ctrl+R |
+| `cursor`, `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | `/whatityped` |
+| `factory` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+
+Ctrl+D ukončí program jen s prázdným skladatelem. Panel `?` vždy vypisuje zkratky aktivního profilu. U `claude-code` se použijí i vlastní přemapování ze souboru `~/.claude/keybindings.json`, u `codex` z `[tui.keymap.*]` v `~/.codex/config.toml`.
+
+Terminál rozhoduje, které zkratky dorazí: Shift+Enter vyžaduje protokol klávesnice kitty (Ghostty, kitty, WezTerm, iTerm2 3.5+), Alt+Enter vyžaduje Option jako Meta na macOS, Ctrl+J funguje v každém terminálu včetně tmux.
+
+**Import při nastavení.** Když nastavení najde jiného agenta, nabídne také import pamětí, relací a dovedností stejným způsobem jako `/import`; neúspěšný import nastavení nezablokuje.
+
+---
+
 ## Nastavení agenta
 
 Řízení chování agenta a limity iterací.
@@ -2036,6 +2059,7 @@ Autohand poskytuje bohatou sadu příkazů lomítka pro interaktivní použití.
 | `/status` | Zobrazit stav relace |
 | `/usage` | Zobrazit model, poskytovatele, kontext a limity využití |
 
+| `/upgrade`| Otevřít konzoli a upgradovat plán Autohand              |
 ### Model a poskytovatel
 
 | Příkaz | Popis |

diff --git a/docs/config-reference_de.md b/docs/config-reference_de.md
@@ -744,6 +744,29 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 
 ---
 
+### Profile für Tastenkürzel
+
+Wer bereits einen anderen Coding-Agenten nutzt, kann den Composer dessen Kürzel folgen lassen. Das Profil wird beim Setup angeboten (wenn Autohand den Agenten findet), unter `/settings` → UI → Tastenkürzel gewählt oder direkt gesetzt:
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+| Profil | Zeilenumbruch | Beenden | Verlauf |
+| --- | --- | --- | --- |
+| `autohand` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+| `claude-code`, `codex`, `devin` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | Ctrl+R |
+| `cursor`, `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | `/whatityped` |
+| `factory` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+
+Ctrl+D beendet nur bei leerem Composer. Das `?`-Panel zeigt immer die Kürzel des aktiven Profils. Mit `claude-code` werden eigene Belegungen aus `~/.claude/keybindings.json` übernommen, mit `codex` die aus `[tui.keymap.*]` in `~/.codex/config.toml`.
+
+Welche Kürzel ankommen, entscheidet das Terminal: Shift+Enter braucht das kitty-Tastaturprotokoll (Ghostty, kitty, WezTerm, iTerm2 3.5+), Alt+Enter braucht Option als Meta unter macOS, Ctrl+J funktioniert in jedem Terminal, auch in tmux.
+
+**Import beim Setup.** Findet das Setup einen anderen Agenten, bietet es zusätzlich an, Erinnerungen, Sitzungen und Skills so zu importieren wie `/import`; ein fehlgeschlagener Import blockiert das Setup nicht.
+
+---
+
 ## Agenten-Einstellungen
 
 Steuern Sie das Agentenverhalten und die Iterationslimits.
@@ -2160,6 +2183,7 @@ Autohand bietet eine umfangreiche Reihe von Slash-Befehlen für die interaktive
 | `/status`     | Sitzungsstatus anzeigen                                   |
 | `/usage`      | Modell, Anbieter, Kontext und Nutzungslimits anzeigen       |
 
+| `/upgrade`    | Konsole öffnen, um den Autohand-Plan zu upgraden            |
 ### Modell & Anbieter
 
 | Befehl       | Beschreibung                                           |

diff --git a/docs/config-reference_es.md b/docs/config-reference_es.md
@@ -395,6 +395,29 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 
 ---
 
+### Perfiles de atajos de teclado
+
+Si ya usas otro agente de programación, el compositor puede seguir sus atajos. Elige el perfil durante la configuración (se ofrece cuando Autohand detecta el agente), en `/settings` → UI → Atajos de teclado, o directamente:
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+| Perfil | Nueva línea | Salir | Historial |
+| --- | --- | --- | --- |
+| `autohand` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+| `claude-code`, `codex`, `devin` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | Ctrl+R |
+| `cursor`, `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | `/whatityped` |
+| `factory` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+
+Ctrl+D solo sale con el compositor vacío. El panel `?` siempre muestra los atajos del perfil activo. Con `claude-code` se aplican tus reasignaciones de `~/.claude/keybindings.json`; con `codex`, las de `[tui.keymap.*]` en `~/.codex/config.toml`.
+
+El terminal decide qué atajos llegan: Shift+Enter necesita el protocolo de teclado kitty (Ghostty, kitty, WezTerm, iTerm2 3.5+), Alt+Enter necesita Option como Meta en macOS y Ctrl+J funciona en cualquier terminal, incluido tmux.
+
+**Importación durante la configuración.** Cuando la configuración detecta otro agente, también ofrece importar memorias, sesiones y habilidades igual que `/import`; una importación fallida no bloquea la configuración.
+
+---
+
 ## Configuración del Agente
 
 Controla el comportamiento del agente y límites de iteración.

diff --git a/docs/config-reference_fr.md b/docs/config-reference_fr.md
@@ -686,6 +686,29 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 ```
 ---
 
+### Profils de raccourcis clavier
+
+Si vous utilisez déjà un autre agent de codage, le composeur peut suivre ses raccourcis. Choisissez le profil pendant la configuration (proposé quand Autohand détecte l'agent), dans `/settings` → UI → Raccourcis clavier, ou directement :
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+| Profil | Nouvelle ligne | Quitter | Historique |
+| --- | --- | --- | --- |
+| `autohand` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+| `claude-code`, `codex`, `devin` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | Ctrl+R |
+| `cursor`, `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | `/whatityped` |
+| `factory` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+
+Ctrl+D ne quitte que si le composeur est vide. Le panneau `?` liste toujours les raccourcis du profil actif. Avec `claude-code`, vos réaffectations de `~/.claude/keybindings.json` sont appliquées ; avec `codex`, celles de `[tui.keymap.*]` dans `~/.codex/config.toml`.
+
+Le terminal décide des raccourcis reçus : Shift+Enter exige le protocole clavier kitty (Ghostty, kitty, WezTerm, iTerm2 3.5+), Alt+Enter exige Option en Meta sous macOS, Ctrl+J fonctionne dans tout terminal, tmux compris.
+
+**Import pendant la configuration.** Quand la configuration détecte un autre agent, elle propose aussi d'importer mémoires, sessions et compétences comme `/import` ; un import échoué ne bloque pas la configuration.
+
+---
+
 ## Paramètres des agents
 
 Contrôlez le comportement de l’agent et les limites d’itération.
@@ -2018,6 +2041,7 @@ Autohand fournit un riche ensemble de commandes slash pour une utilisation inter
 | `/status` | Afficher l'état de la session |
 | `/usage` | Afficher les limites du modèle, du fournisseur, du contexte et de l'utilisation |
 
+| `/upgrade`| Ouvrir la console pour passer à un plan Autohand supérieur                      |
 ### Modèle et fournisseur
 
 | Commande | Descriptif |

diff --git a/docs/config-reference_hi.md b/docs/config-reference_hi.md
@@ -396,6 +396,29 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 
 ---
 
+### कीबोर्ड शॉर्टकट प्रोफ़ाइल
+
+यदि आप पहले से कोई अन्य कोडिंग एजेंट उपयोग करते हैं, तो कंपोज़र उसके शॉर्टकट अपना सकता है। प्रोफ़ाइल सेटअप के दौरान चुनें (जब Autohand एजेंट का पता लगाता है), `/settings` → UI → कीबोर्ड शॉर्टकट में, या सीधे:
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+| प्रोफ़ाइल | नई पंक्ति | बाहर निकलें | इतिहास |
+| --- | --- | --- | --- |
+| `autohand` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+| `claude-code`, `codex`, `devin` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | Ctrl+R |
+| `cursor`, `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | `/whatityped` |
+| `factory` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+
+Ctrl+D केवल खाली कंपोज़र पर बाहर निकलता है। `?` पैनल हमेशा सक्रिय प्रोफ़ाइल के शॉर्टकट दिखाता है। `claude-code` के साथ `~/.claude/keybindings.json` की आपकी रीमैपिंग लागू होती है; `codex` के साथ `~/.codex/config.toml` के `[tui.keymap.*]` की।
+
+कौन से शॉर्टकट पहुँचते हैं यह टर्मिनल तय करता है: Shift+Enter के लिए kitty कीबोर्ड प्रोटोकॉल चाहिए (Ghostty, kitty, WezTerm, iTerm2 3.5+), Alt+Enter के लिए macOS पर Option को Meta बनाना चाहिए, Ctrl+J हर टर्मिनल में काम करता है, tmux में भी।
+
+**सेटअप के दौरान आयात।** जब सेटअप किसी अन्य एजेंट का पता लगाता है, तो वह `/import` की तरह मेमोरी, सत्र और स्किल आयात करने की पेशकश भी करता है; असफल आयात सेटअप को नहीं रोकता।
+
+---
+
 ## एजेंट सेटिंग्स
 
 एजेंट व्यवहार और इटरेशन लिमिट्स को नियंत्रित करें।

diff --git a/docs/config-reference_hu.md b/docs/config-reference_hu.md
@@ -686,6 +686,29 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 ```
 ---
 
+### Billentyűparancs-profilok
+
+Ha már használsz másik kódoló ügynököt, a szerkesztő követheti annak billentyűparancsait. A profilt a beállítás során választhatod (ha az Autohand megtalálja az ügynököt), a `/settings` → UI → Billentyűparancsok alatt, vagy közvetlenül:
+
+```sh
+autohand config set ui.keybindingProfile codex
+```
+
+| Profil | Új sor | Kilépés | Előzmények |
+| --- | --- | --- | --- |
+| `autohand` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+| `claude-code`, `codex`, `devin` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | Ctrl+R |
+| `cursor`, `antigravity` | Shift+Enter, Alt+Enter, Ctrl+J | Ctrl+D | `/whatityped` |
+| `factory` | Shift+Enter, Alt+Enter | Ctrl+C ×2 | `/whatityped` |
+
+A Ctrl+D csak üres szerkesztőnél lép ki. A `?` panel mindig az aktív profil parancsait mutatja. A `claude-code` profil átveszi a `~/.claude/keybindings.json` saját hozzárendeléseit, a `codex` a `~/.codex/config.toml` `[tui.keymap.*]` szakaszait.
+
+Hogy melyik parancs érkezik meg, a terminálon múlik: a Shift+Enter a kitty billentyűzet-protokollt igényli (Ghostty, kitty, WezTerm, iTerm2 3.5+), az Alt+Enter macOS-en az Option Meta-ként való beállítását, a Ctrl+J minden terminálban működik, tmux alatt is.
+
+**Importálás a beállítás során.** Ha a beállítás másik ügynököt talál, felajánlja az emlékek, munkamenetek és készségek importálását is, ugyanúgy, mint az `/import`; a sikertelen importálás nem akadályozza a beállítást.
+
+---
+
 ## Ügynök beállításai
 
 Az ügynök viselkedésének és iterációs korlátainak szabályozása.
@@ -2018,6 +2041,7 @@ Az Autohand perjel parancsok gazdag készletét kínálja interaktív használat
 | `/status` | Munkamenet állapotának megjelenítése |
 | `/usage` | Modell, szolgáltató, kontextus és használati korlátok megjelenítése |
 
+| `/upgrade`| Konzol megnyitása az Autohand-csomag bővítéséhez                    |
 ### Modell és szolgáltató
 
 | Parancs | Leírás |