Skip to main content

Controller mappings in release 0.1.2

Version 0.1.2 uses the same physical actions across profiles, with native shortcuts or optional optimized bindings. Tool behavior still depends on focus, application version, and active context.

Native mode: base controls

Controller Claude Code Gemini CLI Codex Terminal
Cross / A: Submit Enter Enter Enter Enter
Circle / B: Correct Backspace Backspace Backspace Backspace
Square / X: hold 350 ms to interrupt Control+C Escape Control+C Control+C
Triangle / Y: Advance Tab Tab Tab Tab
L1 / LB; R1 / RB Up; Down Up; Down Up; Down Up; Down
D-pad Arrow keys Arrow keys Arrow keys Arrow keys
Left stick up / down Page Up / Down Page Up / Down Page Up / Down Page Up / Down
Left stick left / right Home / End Home / End Home / End Shell line start / end
L3: Activity Control+T Control+T Unavailable Unavailable
R3: Review Control+O Control+O Control+T Unavailable
Start / Menu: Commands Unavailable Unavailable Unavailable Control+R after shell selection
Select / View: Context Unavailable Unavailable Unavailable Paste: Command+V on macOS; Control+Shift+V on Windows

Native mode: hold L2 / LT for the command layer

Controller Claude Code Gemini CLI Codex Terminal
Cross / A: Newline Control+J Control+J Shift+Enter Shell-specific (below)
Circle / B: Dismiss Escape Escape Escape Escape
Square / X: Safe recovery Unavailable Unavailable Unavailable Clear line (below)
Triangle / Y: Permission mode Shift+Tab Shift+Tab Unavailable Previous completion (below)
D-pad left / right Alt+Left / Right Alt+Left / Right Alt+Left / Right Shell word left / right
D-pad up / down Home / End Home / End Home / End Shell line start / end
L1 / LB; R1 / RB Page Up; Page Down Page Up; Page Down Page Up; Page Down Page Up; Page Down
L3: Background Control+B Control+B Unavailable Unavailable
R3: Details Unavailable F12 Unavailable Unavailable
Start / Menu Ultragrip profile picker Ultragrip profile picker Ultragrip profile picker Ultragrip profile picker
Select / View: Shell mode Unavailable Unavailable Unavailable Unavailable

Layers, sticks, and interrupt

Hold L2 to select the command layer; it no longer holds the Control key. Left-stick behavior stays the same in either layer. The right stick scrolls vertically in every profile and never moves the pointer. D-pad and left-stick directions repeat while held. Base-layer X fires once after a 350 ms hold; releasing early cancels it.

R2 voice behavior

On macOS, hold R2 to dictate and release to stop. Double-tap R2 to lock hands-free dictation, then double-tap again to stop. Windows has no native voice capture in 0.1.2.

Optional optimized adapters

Open Settings → Tool adapters and review the Exact binding preview before choosing Install optimized bindings. The installer checks the detected CLI version, blocks conflicting bindings, backs up existing configuration, and validates the result. Config changes after installation return the profile to native mode; Repair bindings and Remove UltraGrip bindings preserve unrelated edits.

  • Claude Code: L2+A sends Alt+Shift+N, L3 Alt+Shift+T, R3 Alt+Shift+O, L2+L3 Alt+Shift+B, and L2+Y Alt+Shift+M. These map to newline, activity, review, background, and permission mode. Installation requires a detected Claude Code version of at least 2.1.18.
  • Gemini CLI: the same actions use F13, F14, F15, F16, and F18; L2+R3 uses F17 for details. Installation requires a detected version of at least 0.35.0.
  • Codex: L2+A uses F13 for newline and R3 uses F15 for review. Installation requires a detected version of at least 0.145.0. Other unavailable actions remain unavailable.

Choose a Terminal shell explicitly

In Settings → Terminal shell adapter, select Zsh, Bash / readline, or PowerShell. There is no configuration installer for Terminal. Until a shell is selected, shell-specific editing and Start's history search are unavailable.

  • Zsh and Bash / readline: newline sends Control+V then Control+J; clear line sends Control+A then Control+K; word movement uses Alt+Left / Right; line start / end uses Control+A / E.
  • PowerShell: newline sends Shift+Enter; clear line sends Home, Shift+End, then Backspace; word movement uses Control+Left / Right; line start / end uses Home / End.
  • L2+Y sends Shift+Tab for previous completion in Zsh and PowerShell. It is unavailable for Bash / readline.

Unavailable actions stay inactive

The AI-tool profiles do not insert slash commands, file mentions, or shell-mode text into an unknown draft. Start and Select in the base layer, L2+Select, and L2+X remain unavailable in those profiles even with optimized bindings. The Custom profile is hidden because no mapping editor is released.

Keep the intended application focused and check the action feedback in Ultragrip. A native shortcut or installed adapter does not make every action valid in every tool context. Additional profiles require the trial or Pro; Claude Code remains available on the free tier.

Help
UltragripSupport assistant