Keyboard Shortcuts

Modes

Armament uses vim-inspired modal input:

ModeDescriptionEnter
NormalNavigation and commandsEscape
InsertText input to the prompti, a, or start typing

In normal mode, single keys trigger navigation and actions. In insert mode, all input goes to the prompt.

Focus Zones

The terminal is divided into focus zones. Tab cycles forward, Shift+Tab cycles back:

ZoneDescription
sidebarAgent list, session info
channelMain output feed
inputCommand/message input
toolTool output panel
panelSide panels (permissions, git)

Default Keybindings

KeyAction
j / kScroll output down/up
g / GJump to top/bottom of output
TabNext focus zone
Shift+TabPrevious focus zone
1-9Focus agent by number
h / lPrevious/next agent

Channel & View

KeyAction
Ctrl+POpen quick switcher
Ctrl+1-4Switch view mode (feed/focus/split/watch)
Ctrl+BToggle sidebar
Ctrl+LClear output
/Focus input with command prefix

Agent Management

KeyAction
Ctrl+NNew agent
Ctrl+WKill focused agent
Ctrl+FFocus/unfocus current agent
Alt+1-9Quick-switch to agent N

Session

KeyAction
Ctrl+SManual checkpoint
Ctrl+ZPause session
Ctrl+QGraceful shutdown
F5Refresh/reconnect

Model & Routing

KeyAction
Ctrl+MCycle models
Ctrl+Shift+MOpen model picker
Alt+ROpen routing config

Input (Insert Mode)

KeyAction
EnterSubmit
Shift+EnterNewline (multi-line)
Up / DownHistory navigation
TabTab completion
Ctrl+UClear line
Ctrl+A / Ctrl+EStart/end of line
Ctrl+ZUndo
Ctrl+YRedo
EscapeExit insert mode

Quick Switcher

Ctrl+P opens the fuzzy-search overlay. Type to filter:

  • Agent names: agent-01, planner, reviewer
  • Models: claude-opus, gpt-4
  • Views: feed, focus, split
  • Themes: red, ice, synthwave
  • Commands: any /command

Press Enter to select, Escape to dismiss.

Customizing Bindings

Override any binding in your config or scripts:

# ~/.armament/config.yaml
keybindings:
  ctrl+g: /git status
  ctrl+shift+r: /session checkpoint
  alt+t: /theme cycle

Or in .arma scripts:

bind ctrl+g /git status
bind ctrl+shift+r /session checkpoint
bind alt+t /theme cycle

Multi-Key Sequences

Some bindings support vim-style sequences:

bind gg /scroll top
bind gc /git conflicts
bind gs /git status
bind gd /git diff

The sequence timeout is 500ms by default. Configure with:

keybindings:
  sequenceTimeout: 800

Context-Aware Bindings

Bindings can be scoped to specific modes or focus zones:

bind:normal j /scroll down
bind:normal k /scroll up
bind:insert ctrl+j /submit
bind:zone:sidebar enter /agent focus $selected