Sessions

The Sessions tab lists the sessions of the host. Tap one to open its transcript and its composer.

The Sessions tab

Pull down to read the list again. With more than one open workspace, a switch above the list shows your workspace or All workspaces. Group sessions by task is a host setting, so all your clients group the same way.

The Sessions tab with the menu of the session Color-code tags open: Mark as Unread, Copy Working Directory, and Copy External Session ID.

Long press a row for its menu:

Mark as Read or Mark as Unread
Copy Working Directory
Copy External Session ID
Rename Session and Archive Session, for a workspace session

To archive a workspace session, you can also swipe its row to the left.

The session screen

The Builder session of Show the notebook count in the sidebar header. The header has the back button, the title, and the clock, lightning, and more buttons. Under it, the workflow steps Spec, Planner, Builder, and QA. The transcript ends with the summary of the Builder. The composer shows its placeholder, the paper clip, the model Haiku 5.5 with low effort, the context ring, and the send button.

Task sessionsAll the sessions of the task. Tap one to open it.
Quick actionsThe next steps, such as Start Builder or Approve Task. A step that is not available tells why.
Session actionsTask Details, Copy Task ID, the pull request, the subagents, and the work views.
AttachmentsAdds a picture or a file. It is off when the model accepts no attachments.
Message optionsThe model and its effort. Tap them to set the model, the effort, and, when the runtime offers them, the agent and the speed of your next message.
ContextHow full the context of the model is. Tap it for the token counts.
SendSends your message. While the agent works, it queues the message. See Send and steer messages.

A subagent session opens read-only. In landscape, the workflow steps move to a panel at the side.

Answer the agent

Sessions

fieldnotesAll workspaces

Needs you0

Running3

fieldnotesIn progressOpen search with a keyboard shortcut
fieldnotesAI reviewRestore focus after closing search
fieldnotesIn progressShow an error when sync fails offline

Recent4

fieldnotesSpec ready12mLet people search notes by title
fieldnotesHuman review25mKeep search closed while typing in a note
fieldnotes1hWhy do tags drop on sync?
design-systemReady for dev2hAdd a high-contrast theme

9:41

1A red badge on Sessions shows that a session needs you.
2Tap the session in Needs you to open it.
3Read the approval request. Then tap Approve once.
4The agent runs the command and continues its work.
5Go back. The session is in Running now.

Open the session in Needs you, approve the request, and the agent continues.

The Spec session Show tag counts in the sidebar with an Input needed card: Should the sidebar show tags with zero notes? The agent recommends Hide empty tags. The card offers Hide empty tags, Show all tags, Other answer, Reset, and Confirm Answers.

Tap a session under Needs you. It opens at the card that waits for you.

Approval required: read the command, then tap Approve once, another approval, or Reject. The runtime of the session decides which approvals show. See Coding sessions.
Input needed: tap an answer, or Other answer. With more than one question, tap Next after each answer, then Review Answers and Confirm Answers.

A Blocked task opens its latest session, or its task details. After your answer, the session moves to Running.

Send and steer messages

Open search with a keyboard shortcut

SpecPlannerBuilderQA

Implement this task and submit the completed change with odt_apply_workflow_event with eventId build-completed. Use taskId fieldnotes-k3x9 for every task-bound odt_* tool call.

readAGENTS.md1ms9:46:35 AM

readsrc/app/keymap.ts1ms9:46:38 AM

listsrc/search1ms9:46:41 AM

bashrg -n keydown src88ms9:46:43 AM

readsrc/app/app-shell.tsx1ms9:46:45 AM

readsrc/search/search-dialog.tsx1ms9:46:46 AM

I add the hook in src/search/use-search-shortcut.ts, and the app shell mounts it once.

The hook and the search dialog are ready. I run the search tests to check them.

bashbun test src/search2.4s9:48:41 AM

Also handle Ctrl+K on Windows and Linux.

Unread9:48:44 AM

The hook already takes Ctrl+K on Windows and Linux. I add a test for each platform.

readsrc/search/use-search-shortcut.test.ts1ms9:48:58 AM

Then run the keymap tests too.

Unread9:49:02 AM

bashbun test src/search src/app3.1s9:49:04 AM

@ for files; / for commands; $ for skillsRespond to the pending approval request above to continue

GPT-6-Astra· medium

9:41

1While the agent works, Send queues your message.
2Tap the queued message, then its zap button.
3The agent reads the message in its running turn.
4To steer a new message at once, tap the zap button.

Queue a message while the agent works, then steer it into the running turn.

While the agent works, you choose when it reads your message:

Send queues the message. The agent reads it when its turn ends.
Steer, the lightning button next to Send, gives the message to the agent in the running turn.
Queued messages show above the composer. Tap the stack, then Steer now, Edit, or Remove.
Stop session stops the turn.

With Steer messages by default on the host, Send steers and the small button queues.

Follow a goal

When the Builder works in Goal mode, the goal row shows above the composer: Goal, the status, the objective, and icon buttons to pause, resume, or clear the goal. Tap the objective to read the whole goal.

To set or change a goal, send /goal with the objective, or /goal pause, /goal resume, or /goal clear. The message shows a Goal chip.
While a goal drives the work, your other queued messages wait until the goal stops.

Start a session

Tap + in the tab bar, then New Session. A new session is a workspace session: it belongs to no task.

The New session sheet with Workspace, Name, Runtime and model, Effort, Custom role, and Work location with Current checkout selected, and the Cancel and Create session buttons.

Choose the Workspace. Type a Name, or leave it empty for a generated title.
Choose the Runtime and model and the Effort. A Custom role gives the agent the instructions of that role. You add custom roles on the desktop.
Choose the Work location: Current checkout, New worktree, or Existing worktree. For Existing worktree, choose the Worktree. For New worktree, choose Existing branch or New branch, then type the Worktree name. New branch also takes an optional Branch name.
Choose the Target branch. Changes compares the session with it.
Tap Create session.

Fork, rename, and archive

Fork: tap the fork icon under a reply of the agent, Fork from this reply. A workspace session asks where the copy works: Same folder or New worktree. A task session forks at once.
Rename: long press a workspace session, then Rename Session. Leave the name empty to use the generated title.
Archive: long press a workspace session, then Archive Session. For a session in its own worktree, Remove worktree and branch is on by default.
Restore: tap Archived Sessions, the archive button at the top of the Sessions tab. Then tap Restore next to a session. If its worktree was removed, the restore makes it again from the target branch of the session. An archived session opens read-only, with Restore Session.