Get started / Quickstart

Quickstart

From a fresh install to a first message: tick your agents, pick a folder and start.

Your first session

1. The welcome screen. The first run is one page. Tick the agents you'll use (one that is not installed offers Install), pick a project folder from the ones Zorvo finds or open another, and press Start. Signing in waits for your first session. You can change all of this later in Settings.
2. Start a session. Click New session at the top of the sidebar, or the + next to a folder. The new session shows its folder, branch and agent as chips above the message box. Turn on New worktree in the branch chip's menu to give the session its own copy, on an agent/<title> branch. Tick more than one agent to compare them.
3. Work with the agent.
   • Answer its permission requests and its questions in the chat.
   • Open Inspector in the top bar to review what it changed, see what it did, read files and open a terminal. See Review changes.
   • Select text in a reply and press Reply to quote it in your next message.
4. Branch off. Point at a message to see its actions.
   • Fork from here under a reply starts a new session from there.
   • Rewind to here on one of your messages takes the conversation back to before it and puts the message in the composer to edit. It asks once more, and files the agent changed stay as they are.

Find your way around

• The sidebar lists sessions by folder, two lines each: the title, then the agent and what it is doing ("Working", "Waiting for you", "Finished, unread"). A folded folder still says what its sessions are doing. Hide sidebar makes room for the chat.
• The Agents button next to Settings, at the bottom of the sidebar, shows your agents and whether each is signed in.
• The top bar shows chips only when they have something to say: the agent's plan (2/4), what runs in the background, and the changes (+42 −11). Double-click the title to rename the session; the ⋯ menu opens it in a new window or in Finder.
• The inspector opens on the right with tabs for Changes, Activity, Files and Terminal. Drag its left edge to make it wider; Zorvo remembers the width.

The composer

The row under the message box shows what your agent offers. Models, permission modes and other settings each get a chip, and the open menu shows the agent's own description under each choice that has one. At most three chips sit in the row; the rest are under ⋯. Zorvo shows only the choices the agent reports.

• Codex has a collaboration mode chip, which is where you put Codex in Plan.
• Claude Code has a fast mode chip and one for its agent persona.
• Gemini CLI and other agents that list their models only through ACP get a model chip too. Your pick is set before your first message, and the next session starts with it.
• A list over ten choices has a search field.
• A mode that lets the agent act without asking (YOLO, bypass, full access) is marked with a shield in the open menu, before you pick it.

Mention files with @, list the agent's commands with /, and drop files and pictures onto the window; an image shows as a thumbnail. The context use reads "38% of context" and opens the numbers behind it. While the agent works, Stop sits where Send was.

Permission modes

Each session starts in the safest permission mode its agent offers (its Default, Manual, Ask or Read-only mode), so the agent asks before it edits files or runs commands. Pick another mode in the composer.