Your first chat

Open a project

A project is a folder your agents work in, usually a repository.

1. In the Agents view, press New project, the folder button beside Projects.
2. Add the folder under Source folders. The first folder is the project: it holds the project's chats, memory and worktrees. Any extra folders are ones the agent may also read and edit.
3. Give it a name, or leave the name empty to use the folder's, and press Create project.

If a one-folder project is not in Git yet, Offrun runs git init in it and says Git is set up in and the project's name. It makes no first commit; make one yourself before you create a worktree. Offrun skips this for your home folder, Documents, Desktop and other personal folders.

For a task that is not about a repository, press New agent at the top of the sidebar. That chat goes in the Default project.

Start a chat

Select the project, then press + in the tab strip or ⌘T. The chat starts in the row you have selected: the project folder, a folder inside it, or a worktree. It is called Untitled until it names itself.

A chat in the project folder edits your files directly, and so does every other chat in that folder. To run two agents on one repository at once, give each its own worktree first. Projects and worktrees shows how.

Choose the agent and model

The chip at the bottom of the message box names the model. Press it, or type /model, to open the model menu:

• Pick an agent from its tabs (Claude Code, Codex, Agy, Grok or Muse Code), then a model. Only agents installed on this Mac appear.
• Set the effort with the slider, from Low up. ⇧Tab in the message box steps through it too.
• If the agent has more than one login, pick one under Account.
• The Reviewer tab turns on peer review for this chat. It is off unless you turn it on.

Build or Planner

The mode button in the message box has two choices:

• Build, the default: Makes the change and runs it to prove it works.
• Planner: Works out the approach and writes it down. Changes nothing. The agent's CLI holds it to read-only.

Type /build or /planner to switch. Each chat keeps its own mode.

Give it the task

Write what you want done and send it. While the agent works, you can type another message. It waits in a queue and goes in when the turn ends, unless Send right away is on in Settings, Agents: then a new message stops the agent and goes in at once. Esc stops the turn.

A turn has no time limit. The agent runs until it finishes or asks you something, as it would in Terminal.

Read what it changed

The answer explains what the agent did. To see the code itself:

• Open a file the agent changed in the preview. A file in Git that differs from the last commit gets a Changes and File switch, so you can read the diff or the whole file.
• The Artifacts button beside the chat lists the documents, slides, sheets, charts and folders it made. Code is left out of that list on purpose.
• Your own tools work as always: git status and git diff in the folder the chat ran in.

Keep it, or not

Offrun has no merge button and never merges for you. Agents usually leave their edits uncommitted, so commit what you want to keep with your usual Git tools, or ask the agent to. If the chat ran in a worktree, merge its branch when you are happy with it.