VCode home

The screen on a phone

Agents: claude, codex, opencode · On: phone, desktop

Two bands of controls float over the conversation: everything above it in #overhead, everything below it in #underfoot. The text scrolls underneath both and fades out into them.

Why you would use it

This is what you are looking at. Knowing which row is which makes the rest of the docs findable: "the mode strip", "the plan strip", "the status bar" all name a row in one of these two bands.

How to use it

Nothing to operate. What sits where, top to bottom:

The whole phone screen: the top band over the conversation, the conversation, and the bottom band.

#overhead — the top band.

  1. The usage meters (#agents).
  2. The mode strip (.modestrip): Agent and Shell (#send-modes), Notify, the folder button (#files-open), then Install (#install) and the cog (#settings-open) at the right edge.
  3. The top bar (.topbar): the tab strip (#tabstrip), the new-thread plus (#new-tab) right after the last tab, and the update-ready arrow (#update-ready, only while an update is waiting).
  4. The plan strip (#planstrip), when the agent has steps to show.

The top band on its own: usage meters, mode strip, top bar, plan strip.

#underfoot — the bottom band.

  1. The offline banner (#offline-banner).
  2. The two-row shell keypad (#tray-keys), while Shell mode is selected.
  3. The subagents strip (#subs).
  4. The status bar (#statusbar).
  5. The slash menu (#slashmenu) and the attachment row (#drafts).
  6. The composer (.composer): agent, model and effort pickers, attach, the composer (#draft), mic, steer and send.
  7. The version row (.app-version): the app's build, written v0.253, and right of it the connection dot (#link-dot).

The bottom band on its own: the subagents strip, the status bar, the composer and the version row with the connection dot.

The conversation (#thread) fills the space between them; in shell mode the pane (#panel) fills the same slot. From 760px up both are a pane's instead, in #panes between the bands — see wide-layout.

What you see

Limits and known gaps