The phone’s sections
The menu button in the phone’s top bar opens the drawer. The drawer lists every section of the app, which are Terminals, WorkMap, Remote Git, Reviews, and Settings at the bottom.
The drawer
The top of the drawer shows the state of the link. It reads Connected to the desktop, Connecting, or Desktop unreachable, retrying.
WorkMap, Remote Git and Reviews show one project at a time. The desktop’s active project comes first, and when several projects are open a chip in the bar picks another. Only the projects ticked in the desktop’s Settings > Mobile Remote can be picked.
Terminals
The first section is the orchestrator. It shows its conversation, any planned tasks still waiting for a decision, and one input box that asks for work in any project. The model picker and the saved prompts sit beside the box. A plan is made against the live workspace, so it knows the open projects and what each terminal last ran. Until the phone is connected, the conversation reads Waiting for the desktop.
The Project Terminals chip opens a pager. Swipe left and right through the open projects. Each page lists that project’s terminals with a status of Working, Done or Idle. Under each terminal is the WorkMap feature it is bound to, or the last prompt it ran.
A terminal
Opening a terminal gives you what the desktop shows for it.
- The transcript, streaming as it arrives.
- An approval card when a run is waiting on one, and the same cost warning card the desktop raises. The first answer from either device wins.
- Two strips of pictures from the run, covered in Pictures and files.
- The branch button, which opens Local Git for that terminal’s own checkout.
- An input box for that terminal alone. A message that starts with an exclamation mark runs as a shell command instead of going to the model.
WorkMap
This is the project’s map as the desktop last saved it. Branches are sections, the nodes hang off one rail, and a node opens into its requirements. You can change a status and add a requirement, and the desktop applies the change to its own map straight away.
A node shows its description, its Summary, its status, and a button for each terminal already bound to it. Under Requirements, each requirement has Change for its status and Details for the conversations filed on it, the files those prompts carried and the token totals. Work starts from a terminal. Use Open a terminal on this node, since the phone’s requirements have no play button.
Remote Git
This section is the project’s own checkout against its remote, as the desktop’s Remote popup shows it. You can refresh, pull, push and squash. A command run on the desktop updates the phone, and the other way round.
Local Git lives on each terminal’s screen, behind the branch button. It shows the branch, its base, the uncommitted changes and the commits, with pull, push and squash for that worktree. It is read again when the terminal opens and after each automatic commit.
Commits and changes are drawn on rails by default. The two icons at the right of each section switch to a plain list.
Reviews
The project’s reviews, one at a time, with the reviewers and two tabs.
- Files shows every changed file with its changes in place, cut to the changed lines with three lines of context around them. A line with a comment carries a marker, and tapping it opens the thread.
- Comments lists every comment on the review.
A comment, a reply, a check and a status change all go through the same review service the desktop uses. A file longer than 1500 lines is cut, and the diff says so.
Settings
Settings shows the desktop this phone is linked to, the appearance as System, Light or Dark, and the app version. Disconnect asks once more before it acts. It ends the session on both sides, wipes what the phone holds, and returns it to the scan screen.