Omniscio

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

  1. 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 (0o600 on Unix, an ACL grant to your user on Windows) and deleted when you disable CLI Control or quit Omniscio.

  2. 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-control skill 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).

  3. 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 calls GET /keybindings to discover them — every endpoint, including reads, requires the bearer token. It will tell you the action label and current bindings before changing anything.

  4. Watch for conflicts. The list response includes a conflicts array — each entry names two actions in the same context that share a binding. The AI surfaces these and asks before overwriting.

  5. Changes apply instantly. As soon as the PATCH/PUT/DELETE succeeds, the renderer's keybindings store re-resolves bindings on the SETTINGS_CHANGED push 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.

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.

Last verified 2026-09-28