Keybindings Reference

All agent-shell keybindings are available in two forms:

  • In-buffer: C-c <key> — short form, only inside agent-shell buffers
  • Global: C-c A <key> — works from any buffer

The C-c A prefix is labelled "Agent" in which-key.

Session Management

In-bufferGlobalAction
C-c sC-c A sSession picker (live + saved + new)
—C-c A gGrep sessions (full-text search across all history)
C-c qC-c A qQuit session (saves automatically)
C-c hC-c A hView history (current session or pick)
C-c HC-c A HView history (always pick)
C-c rC-c A rRename buffer
—C-c A aStart / switch to agent
—C-c A nForce new session
—C-c A kInterrupt agent
C-c bC-c A bSwitch agent buffer (live only) — MRU order, status-coloured

In-Picker Keys

Every session-facing picker (C-c A s, C-c A b, C-c A g) prefixes each row with a provider glyph — A Auggie, C Claude, P Pi — and shares a set of picker-local action keys:

KeyAction
M-a / M-c / M-pToggle visibility of Auggie / Claude / Pi rows (filter is shared across all three pickers; not persisted)
M-wToggle workspace filter (all workspaces ↔ the calling buffer's workspace); active filter shows in the prompt as [~/path/to/ws]
C-SPCMark row for batch action
C-kKill highlighted live session buffer(s)
C-dDelete saved / previous session from disk and metadata
C-uExpand (per-picker; e.g. C-u C-c A s shows every saved snapshot instead of one-per-conversation)

Input & Editing

KeyAction
C-c e / C-c A eCompose buffer (multi-line editor)
RETSend prompt (at end of input)
S-RETInsert newline in prompt
C-c C-cInterrupt running agent
C-c EInterrupt agent and open compose buffer
TABExpand yasnippet template

In Compose Buffer

KeyAction
C-c C-cSubmit composed prompt
C-c C-kCancel / close compose buffer
C-c C-sToggle sticky (stays open) vs transient
C-c k kInterrupt agent
C-c k C-cInterrupt agent and submit
M-pPrevious prompt (history)
M-nNext prompt (history)
M-rSearch prompt history (consult)

Templates (C-c Y / C-c A t)

In-buffer, snippet insertion is handled by the upstream C-c Y ("+snippet") prefix — no decknix-specific in-buffer binding. The agent-namespaced C-c A t global prefix is preserved for explicit, namespaced access.

KeyAction
C-c YSnippet prefix (upstream) — insert / new / visit
C-c A t tInsert a prompt template
C-c A t nCreate new template
C-c A t eEdit existing template

Commands (C-c c / C-c A c)

KeyAction
cPick & insert a slash command
nCreate new command
eEdit existing command
rReview PR by URL (quick action; launches in the pr-review purpose's auto mode)
BBatch process (multi-session launcher)
lLink PR to session
LLink repo+branch to session (direct-push repos)
uUnlink PR or repo (single picker)

Tags

Conversation-scoped tags (add / remove / list for this session) are now nested under the session sub-prefix at C-c s t. Global tags (rename / delete / cleanup across all sessions) remain at C-c A T.

Conversation-scoped (C-c s t)

KeyAction
aAdd tag (create or select)
rRemove tag
lList this session's tags

Global (C-c A T)

KeyAction
tTag current session
rRemove tag
lList / filter by tag
eRename a tag
dDelete tag globally
cCleanup orphaned tags

Trigger sidebar transients without switching focus away from the agent-shell buffer. C-c W opens decknix-sidebar-transient — the same parent menu that the sidebar's ? / h opens — exposing Navigate / Quick / Actions plus T for the toggles sub-transient.

KeyAction
C-c WOpen sidebar action transient
C-c W TToggles transient (filters, sort, indicators)
C-c wToggle the workspace tab itself (unchanged)

Model & Mode

In-bufferGlobalAction
C-c C-v—Pick model (persists per-conversation; survives resume)
C-c C-m—Pick permission mode (persists per-conversation; survives resume/fork)

See Model Selection for the recommended-model-by-task table and the per-purpose (programs.emacs.decknix.agentShell.purposes) / framework (decknix.cli.auggie.settings.model) override levers.

Context (C-c i / C-c A i)

KeyAction
iList tracked issues
pList tracked PRs
cShow CI status
rShow review threads
aPin issue/PR to context
dUnpin from context
gOpen in browser
fVisit in forge
In-bufferGlobalAction
C-c IC-c A IFull context panel

Extensions

In-bufferGlobalAction
C-c mC-c A mManager dashboard toggle
C-c wC-c A wWorkspace tab toggle
C-c jC-c A jJump to session needing attention
—C-c A SMCP server list

Help

In-bufferGlobalAction
C-c ?C-c A ?Full keybinding reference (this page, in Emacs)