Agent Manager
Run several tasks side by side, each in its own Git worktree and branch.
The Agent Manager runs several tasks at once, each in its own worktree: a separate folder and branch for the task, so agents work side by side without editing the same files. Your own checkout stays as it is.
Before you start
- Your workspace folder must be a Git repository.
- Pull request badges need a GitHub CLI sign-in.
Open the Agent Manager
- Click the Agent Manager icon in the Sypha panel's toolbar. It opens in its own editor tab, named "Agent Manager".
- The worktree list on the left starts with local, your current branch. Click New Worktree, or Create a worktree, to give a task its own worktree.
- Start a session in the worktree from its message box, with the same mode control as the Sypha panel.
The Agent Manager stays open in its tab, so you can return to the Sypha panel whenever you need it.
Pull requests
Each worktree's branch shows its pull request status, and the badges update on their own.
With Push Pull Request Fixes turned on under Settings › Agents, sending a pull request's CI failures or review comments to the agent, or updating a worktree from its base, asks the agent to commit and push so the pull request updates. Permission prompts still apply. Turn the setting off to keep commits manual.
Settings
Settings › Agent Manager sets automatic branch naming and the branch prefix. To manage sessions and worktrees across more than one project, try Multi-Project Agent Manager under Settings › Experimental.
Tips
- Give each independent piece of work its own worktree, so parallel agents never edit the same files.
- Worktrees belong to the current repository; to work with another repository, choose another project.