Skip to main content
Documents Stack 0.2.0-dev.20260701.1. Expanded in the 2026-07-01 changelog entry — keyboard map, Agent Bridge, ops panels.
Stack is a terminal cockpit: Agent input on the bottom, status rails on the sides, and a center pane that switches between goal views, transcripts, and ops panels.

​
Launch

stack          # open the cockpit
stack doctor   # verify harness, stackd, and config before a long session
Stack auto-starts stackd on 127.0.0.1:8792 when healthy. See stackd.

​
Agent input

KeyAction
EnterSend the prompt to Codex (or steer during an active turn)
Ctrl+EnterQueue the current input for the next turn
EscInterrupt the active turn, or clear input when idle
TabMove focus: Agent input → model → effort → environment → Local Research → hosted optimizers → remote SMR → session history
/exitQuit Stack explicitly
Codex is the default harness. Configure it in Quickstart § Configure with Codex.

​
Agent Bridge (x)

Press x to toggle local-only vs remote-only bridge mode.
ModeLeft rail shows
LocalLocal GEPA / optimizer jobs and local research state
RemoteAuth, hosted optimizers, live SMR runs, Factories, mediation target
Keep modes separate so Codex does not mix local service actions with remote owner-route actions. Start remote ops with the stack_status MCP tool (see Stack MCP).

​
Environment (dev / staging / prod)

When the environment control is focused:
KeyAction
j / kMove across dev, staging, and prod
rRefresh account, hosted optimizers, and remote SMR snapshot
Set API keys per environment in Configuration.

​
Local Research (GEPA)

When Local Research is focused:
KeyAction
EnterStart the local GEPA service (if installed)
rRefresh job list
j / kMove through recent optimizer jobs
See Optimizers for task setup.

​
Hosted optimizers

When hosted optimizers are focused:
KeyAction
rRefresh jobs from the selected environment
j / kSelect a job
oCycle artifact names for the selected job
v / d / cStage preview, download, or cancel
EnterConfirm the staged action

​
Remote SMR and Factory

When Remote SMR is focused:
KeyAction
rRefresh remote jobs
j / kSelect a run
fCycle Factories
tCycle mediation target (run → Factory → hosted optimizer)
mStage a message to the selected run or Factory project
oCycle WorkProduct / artifact outputs
v / d / lPreview output, download, or preview last saved download
EnterConfirm staged action
Downloads persist under .stack/downloads/<environment>/<run-id>/ and survive TUI restarts.

​
Ops panel modes

Press p on the ops panel to cycle Actors → Local → Synth Hosted. Actors shows Codex subagent policy, primary actor state, and transcript-derived workers. Press enter in Actors mode to toggle subagents for the next launch (when STACK_CODEX_ARGS is not locked).

​
Sessions and logs

Stack writes session logs under .stack/sessions/. Remote visibility includes SMR runs, WorkProducts, artifacts, Factories, and hosted optimizer jobs for the selected environment.

​
Next