Perch
Guide contents

Field guideStart work

Start work on an issue

Give an agent an issue to work on, check its changes, and open a pull request.

1. Create a worktree

Open the issue, choose Start Work from its details menu, and confirm with Create worktree. Perch gives the issue its own branch, such as perch/issue-2233.

Confirmation to create a worktree from the open issue, with its title and the Create worktree button

Starting without an issue? Press Cmd-N (Ctrl-N on Linux) for the new worktree form.

2. Ask the agent to make the change

Describe the fix. Auto-review is the default permission mode. When a command needs your approval, read it in the thread and choose whether to allow it once, save an approval, or deny it. See agent permissions for the other modes.

3. Inspect the diff and commit the changes

In Code, choose Last run to inspect the agent’s diff. You can also have other agents review it.

Perch worktree conversation showing the Pull request status bar and completed Codex Astra 6.2 Work summary
The Pull request bar shows when you still need to commit.

Commit what you want to publish, in a terminal or by asking the agent. For Claude Code, approve git commit when prompted. Codex can make a plain commit directly.

4. Push and open the pull request

With a commit ahead of the base, click Open pull request…. Check the title and description, then submit. Perch pushes the commits and opens the PR. Uncommitted edits stay in the worktree. See Opening a pull request for drafting options and push errors.