New Task & Conversation
New Task
Click “New Task” (Cmd/Ctrl+N) for an empty session page:
- Select a project (defaults if unselected)
- Select a run location (Local / Cloud, see below)
- Type your first message to establish the session
Each task corresponds to an independent backend AgentSession with its own session records context file.
Run Location (Local / Cloud)
When no project is selected, you can switch the run location between “Local / Cloud” on the settings bar:
- Local: the task runs on your computer (default)
- Cloud: the task runs in your organization’s cloud sandbox; enable it first under Settings → Cloud. If cloud is unavailable, you’ll be prompted to start the sandbox first
Note: the run location cannot be changed after a session is created; a cloud session reports an explicit error when the cloud goes offline instead of silently falling back to local. Projects pick their run location at creation and it stays locked. See Cloud for details.
Composer
- Multi-line text, Shift+Enter for newline
- Drag files or click the paperclip for attachments
- Type
/for Slash commands (skill invocation, session actions) - Drafts auto-save per session
Send & Interrupt
- Send: Enter to send. During streaming, the send button becomes “Append” — new messages queue until the current turn finishes
- Interrupt: Click “Stop” to abort; generated content is preserved
Background Tasks
Long-running commands can be handed to the background by LanMate — no need to wait around:
- Backgrounding returns a task number immediately; keep chatting or switch away to other things
- All background tasks show up in a unified panel, with run status at a glance
- Asked on quit: for background tasks still running, you can choose “keep running” (pick up the results next time you open the app) or stop them all together
- Background tasks are protected by approvals too; resident-type commands force confirmation
Steer
Noticed mid-run that LanMate is heading the wrong way? No need to wait for it to finish:
- Click “Steer” on the queued-message bar and your message joins the current turn immediately
- Or set “Follow-up handling” to “Steer” (Settings → General), then just press Enter while LanMate is outputting to cut in line (the default is “Queue”, so switch first)
- LanMate receives your correction on its next step and changes course—no need to stop and start over
Great for mid-run corrections like “wait, don’t touch the second file” or “show it as a table instead”.
Queued Messages (followUp)
While LanMate is outputting, pressing plain Enter queues your message:
- Queued messages send automatically in order when the current turn ends
- You can edit or cancel while queued (buttons on the message bar)
- Want to cut in line? The input shows a shortcut hint—press it to steer immediately
Queueing is “wait for it to finish, then talk”; steering is “change course now”—the former doesn’t interrupt, the latter cuts in.
Streaming Render
Messages render in four stages:
- Thinking: Agent reasoning (collapsible, reasoning models only)
- Tool calls: Operations in progress (file reads, code execution, searches)
- Content: Final reply (Markdown with syntax highlighting)
- Artifacts: Generated file cards, click to preview
Session Operations
Right-click a session: rename, archive (recoverable), move to project. Cmd/Ctrl+W or Backspace archives the current session.
Task Status
Task execution has clear stage indicators:
- Running: the message stream shows current tool calls and progress
- Waiting on you: approval or info requests surface as a card at the top of the stream, with app notifications and a pet bubble
- Done: artifact cards show the results; desktop notifications fire when running in the background
Long tasks don’t need babysitting—switch away, come back, and review.