Skip to main content
The Chat tab is the conversational surface. It is separate from the Code workbench: Code is for spawning and controlling agent sessions tied to a repo; Chat is for prompt-driven work where you want the focus on the conversation.

Modes

One provider, one thread. Pick any configured provider — Claude, Codex, Antigravity, Cursor, or OpenRouter — and start a conversation. The history sidebar on the left lists past sessions; search narrows it. Continue any past session by clicking it.

Turn lifecycle

Wire v14 introduced TurnState on WireChatSnapshot. The “done” signal is now authoritative from the daemon, not a “no new event in 2 s = done” heuristic. Older paired Macs (wire < 14) fall back to the heuristic automatically.

Stopping a turn

Stop behavior varies by backend:
ProviderStop mechanism
ClaudeESC sent to the direct PTY
CodexHarness cancellation
CursorHarness cancellation
Gemini / AntigravityHarness cancellation
GrokHarness cancellation
OpenCodeHTTP cancel (where available)
The Send button becomes a Stop button while a turn is in progress.

Deep Research

Deep Research is a creation-time toggle available for Claude, Codex, and Antigravity sessions. It is verified by tools/verify-deep-research.sh. Enable it from the new-session sheet or the mode toggle chip.

Permission prompts

When an agent needs explicit approval — a file write, a shell command, a network call — the PermissionPromptCard appears inline in the thread. The card is shared between Mac and iPhone via ClawdmeterShared, so the prompt shape is identical on both surfaces. Approve or deny without leaving the chat.

History

The left sidebar lists all chat sessions. Use the search field to filter by title or content. Sessions that were part of a Broadcast group that resolved via pick-winner appear as regular Solo chats after the winner is chosen.
  • Broadcast — multi-provider comparison, star and pick-winner.
  • Composer — slash commands, attachments, and voice input.