Terminal Keys and the Agent Console

  • Mobile app
  • All plans

What it does

Everything a physical keyboard lets you do in an agent's terminal, from a phone screen, on a console laid out like the desktop pane so nothing has to be relearnt.

One key rail sits above the input box and changes with what you are doing. Keyboard closed, it is the remote: esc, the four arrows, Enter, Shift+Tab, Ctrl+C and Backspace, the keys an agent CLI asks for in its dialogs. Keyboard open, it is what a physical keyboard would add: Ctrl and Alt modifiers, Tab, Backspace, the history arrows, Enter and /. At its right end, More keys replaces the soft keyboard with an eight-row grid of terminal keys (function keys, Home and End, page keys, control chords, brackets, pipe, paste); at its left end, the Direct toggle sends every keystroke straight to the terminal.

The input box takes the whole width, like the desktop composer, with its tools under it: attach (Attach), Prompt library, Skill library, the dictation microphone and the Send pill. Send later is in the + sheet, next to the attach choices; a long press on Send opens it too.

The console's floating buttons sit where the desktop pane puts them: top right, Scroll to top / Scroll to bottom and Fullscreen (the header folds away, Exit fullscreen brings it back); bottom right above the input box, Show the conversation / Show the terminal, Ask on the side and Listen to the last answer. Both clusters fold away while the keyboard is up and come back when it closes.

The header mirrors the desktop session header: the avatar with its status dot, the task title with the project logo beside it, the role pill that morphs the agent, then the spec pill (CLI, model, context window) with the token count beside it, on three lines, then the AgentsRoom tools button (a plug with a status dot, see Agent Tooling Status), Review changes (filled with a count while the agent has unreviewed files) and Agent actions. A tap on the avatar or the title opens Agent's card, a read-only version of the desktop agent card with the role, the session name, the agent prompt and its Agent stats.

Where to find it

  • Mobile app > Projects > a project > tap an agent to open its console.
  • Key rail above the input box: Direct (left end), the contextual keys, More keys (right end, Back to the keyboard while the grid is up).
  • Top right of the output: Scroll to top / Scroll to bottom, Fullscreen / Exit fullscreen. Bottom right: Show the conversation, Ask on the side, Listen to the last answer.
  • Under the input box: Attach (files, photos and Send later), Prompt library, Skill library, the microphone, Send (long press: Send later).
  • Header: the role pill (Morph the agent), the avatar and title (Agent's card), Review changes, Agent actions (morph, Live preview, close session, delete), the Back chevron.

How to use it

  1. Open an agent console. With the keyboard closed, the rail shows the remote keys: Escape, Left arrow / Up arrow / Down arrow / Right arrow, Enter, Shift+Tab, cycle the permission mode, Ctrl+C and Backspace. A tap goes straight to the terminal.
  2. Tap the input box: the keyboard opens and the rail switches to the typing keys (Ctrl, Alt, Tab, Backspace, arrows, Enter, Slash command).
  3. Tap More keys to swap the soft keyboard for the extended grid. Byte keys (esc, F1 to F12, home, pgUp, ^C, ^Z...) are sent as is; character keys (|, ~, {, @...) are typed into the input box, or turned into a chord when a modifier is armed. Tap the field, or the grid button again, to get the keyboard back; a swipe down on the panel closes it too.
  4. Chords: tap Ctrl then a key (Ctrl armed, type a key (S sends Ctrl+S)…), or Alt then a key (Alt armed, type a key (B sends Alt+B)…). One modifier is armed at a time and is consumed by the next key, from the keyboard or from the grid.
  5. Copy text: touch and hold the terminal output for half a second. Select text opens with what the terminal shows, scrolled to the lines you were reading: touch and hold a word, drag the handles, then use the system Copy (or Share) to paste it in another app; Copy all at the top right copies everything. The terminal keeps running behind it; close the sheet to come back. On a very long session, Copy all can be refused on Android (Too long to copy in one go. Select a part of it instead.): select a part instead.
  6. Open a link: tap a web address (http:// or https://) printed in the output; it is underlined and opens in the phone's browser. A long address that the terminal cut over two or three lines opens whole, wherever you tap it. A file path printed by the agent opens in the file viewer instead. Works on agent consoles, dev command terminals and SSH terminals; in the conversation view, addresses in the agent's answers are links too.
  7. Leave the console with the Back chevron, or a swipe from the left edge of the screen.

The rail, the extended grid and the modifiers are also available on a dev command terminal and on an SSH terminal opened from the phone; the / key and the library buttons are specific to agent consoles. On those shell terminals, the keyboard's Return key (bottom right) runs the line, like Send, and Send works on an empty input box too: that plain Enter is how you run a line Tab has just completed.

Settings

None on the desktop or on the phone.

Agent tools (MCP)

None. Keys arrive in the desktop terminal exactly as if typed there.

Providers

All providers, no difference. The pad sends terminal keys, not CLI commands: Escape, Shift+Tab, Enter, the arrows and Ctrl+C are read the same way by Claude Code, Codex, Grok, Kimi and every other CLI.

Mobile

This is a mobile-only feature: it exists because the phone has no physical keyboard, so the desktop has nothing to port.

Limits

  • Text keys from the grid are typed into the input box, not sent on their own, unless Direct mode is on (Direct sends every keystroke immediately).
  • The grid is fixed: no custom keys, no stored passwords (secrets have their own door, see Secret Manager).
  • Agent's card is read-only on the phone: renaming the agent or editing its prompt is done on the desktop. The prompt shown is the agent's custom prompt when it has one, otherwise the description of its role.
  • A localhost address opens in the phone's browser, which cannot reach your computer: share the dev server with the live preview instead (see Localhost Tunnel).
  • Rarely, a complete address that ends exactly at the right edge of a line takes the first word of the next line with it; touch and hold the output and copy the address from Select text instead.
  • Stats (Active, Idle, Sessions, Prompts, Tokens, Cost) come from the account's project statistics, so they need the desktop to have reported them; a fresh agent shows No stats for this agent yet.

Common questions

  • How do I answer a Claude permission prompt from the phone? The Permission Required card still has Allow / Deny; for anything the card does not cover, use the remote: arrows and Enter pick an option, Escape dismisses.
  • How do I take the reply Claude Code suggests in grey? Since 2026-10-27, with the input box empty (and Direct off), tap Tab on the rail or the Use suggestion chip above the box: the suggestion lands in the input box, ready to edit and send. Before, Tab accepted it in the terminal only and left the phone's box empty. See Sent messages history and messages held by a CLI question.
  • How do I cycle Claude's permission mode? Close the keyboard and tap the Shift+Tab key on the rail.
  • Where did the game-pad remote go? Into the rail: with the keyboard closed, the rail IS the remote, and nothing floats over the CLI's status line any more.
  • How do I get more rows on screen? Tap Fullscreen (top right): the header folds away. Exit fullscreen brings it back.
  • Letters went missing when I typed fast in Direct mode. Fixed on 2026-09-28: the phone now groups a burst of keystrokes into one ordered message to the desktop instead of one per character. Update the phone app.
  • How do I press Enter in an SSH or dev command terminal? With the keyboard's Return key, bottom right: on a shell it runs the line instead of starting a new one. Typed -- that the phone turned into a long dash is changed back before it reaches the shell.
  • How do I copy text from the terminal to paste it in ChatGPT, Gemini or another app? Touch and hold the output: Select text opens; select a passage with the handles and the system Copy, or tap Copy all. Works on agent consoles, dev command terminals and SSH terminals. To copy an agent's whole answer as clean text, open the conversation (Show the conversation) and tap Copy answer under it.
  • Links in the agent's terminal are not clickable on my phone. Fixed on 2026-10-09: web addresses printed in a terminal of the phone are links now, long ones cut over several lines included, and so are addresses written in clear in the conversation view. Update the phone app.
  • Can I send Ctrl+Z or a function key? Yes, from More keys: ^Z and F1 to F12 are on the grid.