Quick start
This walks through one task from start to finish. You need Weir installed, a Git repository, and Claude Code, Codex, Antigravity, or OpenCode signed in.
1. Open your project
Section titled “1. Open your project”Press ⌘O and choose your repository’s folder. It appears in the sidebar as a project, with its own folder as the first row.
2. Make a worktree for the task
Section titled “2. Make a worktree for the task”Press ⌘N to open New Worktree. Choose a new or existing branch and the agent to open, then press ⌘⏎ to create it.
The worktree gets its own folder and a new row in the sidebar, so this task’s files stay apart from your other work.
Files Git ignores, such as .env, are not copied unless you choose them in Project Settings.
3. Give the agent its first instruction
Section titled “3. Give the agent its first instruction”Weir opens the agent in a terminal. In a folder it has not seen, the agent may first ask whether you trust it. Then type your instruction in its prompt, as you would anywhere else.
The sidebar row and the bar under the pane now show what the agent is doing. Nothing moves or takes focus on its own, so you can leave it running and do something else.
4. Go to it when it needs you
Section titled “4. Go to it when it needs you”When the agent asks for approval, asks a question, stops, or finishes a turn, the item joins Needs Attention. Press ⌘J to go to it.
To answer an approval or a question, choose Answer… on the bar under the pane, or press ⌘⏎, and answer on the card that opens. Codex and OpenCode questions and everything Antigravity asks are answered in the agent’s prompt. See Needs Attention and approvals for the other ways.
5. Review the turn
Section titled “5. Review the turn”A finished turn that changed files opens in a review tab when you reach it with ⌘J. If you are already at its pane, press ⌥⌘R.
To ask for a fix, click a line number, press C, write your comment, and choose Add. Then choose Insert n Comments. Your comments go into the agent’s input as one message, and you press Return to send it. Nothing is sent until you do.
6. Mark it as viewed
Section titled “6. Mark it as viewed”When you have read the turn, press ⌘⏎ for Mark as Viewed. It leaves Needs Attention, and the review closes.
If you do not want the turn, use Restore Code to Before This Turn… in the bar’s ⋯ menu instead. With several unviewed turns, the menu names the first one, such as Restore Code to Before T1…. Once the turn is marked as viewed, the same command is on its card in the Changes panel (⌥⌘I). See Review changes.
Where to go next
Section titled “Where to go next”Press ⌘/ to see every shortcut, or ⇧⌘P to find a command by name. To run another task at the same time, go back to step 2.