Change keyboard shortcuts by asking AI
Any Claude Code session on your machine can read and rebind Omniscio's keyboard shortcuts in plain English once CLI Control is enabled — no clicking through Settings, and the change takes effect immediately with no approval step. Covers the phrasings that trigger it, the validation rules a binding must pass, and the conflict report.
On this page
What it is
Omniscio has ~80 keyboard shortcuts you can rebind in Settings → Keyboard Shortcuts — global ones like Ctrl+Q (open inbox), session-scoped ones like S (snooze) and P (pause), Gmail two-key chords like G > I (go to inbox), and diff-review keys like J/K (next/prev file). Every action carries a label, a description, a default binding list, and your override list. Instead of clicking through that settings page, you can tell an external AI — Claude Code in any project on your machine — "remove E as the close-panel hotkey" or "rebind snooze to Shift+S" and it will do it for you. The AI uses the omniscio-control skill bundle (keybindings surface — keybindings.md), which reads the auto-delivered token from ~/.amc/cli-token and PATCHes Omniscio's local control server at 127.0.0.1:19519. Changes apply immediately to live sessions — no restart, no approval gate. Conflicts (two actions sharing a binding inside the same context) are reported back so the AI can ask before clobbering.
Where to find it
The shortcuts themselves are listed and edited in Settings → Keyboard Shortcuts, which stays the reference for what exists and what is currently bound. The AI route edits the same data and needs switching on once, in Settings → CLI Control — after that, a Claude Code session on your machine can read and rebind shortcuts for you with the settings page never opened. Nothing appears in the sidebar or on a panel for this: the whole interface is the conversation you are already having.
How it behaves
How to use it
Enable CLI Control once. Open Omniscio → Settings → CLI Control and flip it on. Omniscio starts its local control server and writes your auth token to
~/.amc/cli-token(on Windows,%USERPROFILE%\.amc\cli-token). The file is permission-hardened (0o600on Unix, an ACL grant to your user on Windows) and deleted when you disable CLI Control or quit Omniscio.Ask an AI in plain English. In any Claude Code session say something like:
- "Remove E as the archive hotkey in Omniscio"
- "Rebind snooze to Shift+S"
- "Reset my close-panel shortcut to defaults"
- "What's currently bound to Ctrl+Q?"
- "List every Gmail shortcut"
The
omniscio-controlskill bundle auto-activates on phrases like rebind, change shortcut, change hotkey, reset shortcut, or what is bound to (one of many surfaces it covers — see omniscio-control.md).Let the skill find the right action. Action IDs are camelCase strings like
closePanel,snoozeSession,gmailArchive,diffNextFile,jumpToProject1. The AI either knows them already or callsGET /keybindingsto discover them — every endpoint, including reads, requires the bearer token. It will tell you the action label and current bindings before changing anything.Watch for conflicts. The list response includes a
conflictsarray — each entry names two actions in the same context that share a binding. The AI surfaces these and asks before overwriting.Changes apply instantly. As soon as the PATCH/PUT/DELETE succeeds, the renderer's keybindings store re-resolves bindings on the
SETTINGS_CHANGEDpush event, and live sessions pick up the new shortcut without a restart.
Rate limit: keybinding mutations share the same 10/min ceiling as cron and automation mutations. The skill surfaces this if you hit it.
No approval gate: unlike cron jobs and automation rules (which land as pending until you click Approve), keybinding changes apply immediately. Personal preferences don't carry the same blast radius as scheduled command execution, so the user-in-the-loop step is dropped.
Related
What every shortcut does by default, and the context each one applies in, is listed on the Keyboard shortcuts page. If you want to see which of them you actually use — worth knowing before removing a binding — see Hotkey usage, and Hotkey training mode covers learning the bindings in the first place.
- cli-control.md — the parent CLI Control feature (server, token, read-only endpoints)
- create-cron-job-with-ai.md — a sister skill with the same auth pattern but approval-gated
- use-skills.md — how skills work in general
Last verified 2026-09-28