Skip to main content

Work Across Repositories in Agent Manager

Experimental

Turn on Multi-Project Agent Manager in Settings → Experimental to use this feature.

With multiple projects, one Agent Manager window manages worktrees and sessions for several Git repositories. The repository open in VS Code is always the default project; the projects you add stay listed after a restart.

Add a project​

In the PROJECTS section of the Agent Manager sidebar, select Add project..., then choose:

  • Open local folder... to add a repository that already exists on your computer;
  • Clone repository... to clone it from a Repository URL, such as https://example.com/org/repo.git or git@example.com:org/repo.git;
  • New project... to create a new Git project with a Project name in a Parent folder.

If the repository is already listed, Agent Manager opens the existing project instead of adding it twice.

Work in a project​

Select a project to see its worktrees and sessions. When you create a worktree, the dialog asks you to Select project, so the new worktree starts in the right repository. Each project keeps its own base branch and setup script in Project settings.

Remove a project​

Open the project's menu and select Remove from Agent Manager. This removes it from the list only; the repository and its files stay on disk. A project whose folder was moved or deleted is marked Repository not found.