Skip to content

Clarify keyboard shortcuts and mode semantics #15

Open

Description

@androidand

Clarify keyboard shortcuts and mode semantics

Problem

  • Shift+Tab currently cycles agents (agent_cycle_reverse) in the TUI
  • Claude Code uses Shift+Tab to toggle run modes (manual/auto)
  • There is no keyboard shortcut to toggle auto mode (auto_mode + auto_continue) in the TUI
  • The distinction between agent mode cycling and run mode cycling is confusing

Current state

Keybindings from packages/tui/src/config/keybind.ts:

  • agent_cycle: tab — "Next agent"
  • agent_cycle_reverse: shift+tab — "Previous agent"

Auto mode configuration:

  • auto_mode: auto-approves tool permission prompts
  • auto_continue: auto-continues session turns
  • No single shortcut toggles both

Fix

  1. Define what Shift+Tab does — keep it as agent cycling for consistency with Tab cycling, OR change it to match Claude Code's behavior. Decision needed.
  2. Add a shortcut to toggle auto mode — propose ctrl+shift+m or <leader>m for "Toggle auto mode" (enables both auto_mode and auto_continue)
  3. Document the distinction — update keybindings docs to clearly separate "agent mode" from "run mode"

Verification

  • Update packages/tui/src/config/keybind.ts with new keybinding
  • Update packages/web/src/content/docs/keybinds.mdx and translations
  • Ensure the TUI command palette shows the new keybinding

Tasks

Tasks

  • 1. Audit current keybindings in packages/tui/src/config/keybind.ts
  • 2. Decide: does Shift+Tab stay as agent cycling, or change to match Claude Code?
  • 3. Add new keybinding for toggle auto mode
  • 4. Update keybindings documentation
  • 5. Update translations
  • 6. Verify in TUI
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions