Projects, threads & worktrees

Synergoi's mental model is small: a project is a folder, a thread is a conversation with one or more agents about that folder, and by default every thread gets its own git worktree on its own branch. Agents in different threads can never step on each other's files.

Projects

Add a project from the sidebar's + or the first-run screen by picking a folder. If it is a git repository, Synergoi registers it and offers branches; if it isn't, you can still chat about it in a read-only scratch mode. A project does not have to be code at all — see Files & documents projects. Project settings (open from the project's … menu) hold the default base branch, env files, port range and other per-repo choices. Deleting a project removes Synergoi's records and managed worktrees; your folder is never touched.

Threads

⌘N starts a thread in the current project. The header shows which branch and checkout it is bound to, an Open in VS Code button (the editor and command template are configurable), a Focus toggle, and the split control for opening more panes side by side — up to six.

Worktrees and modes

Each thread runs in one of two modes, chosen when it starts and shown in the footer:

• Work on a branch (default). Synergoi creates a git worktree in its managed location on a fresh branch named after the thread. The agent edits there. Your main checkout stays exactly as you left it, and you can run several threads on the same repo at once.
• Edit my project directly. The agent works in your actual checkout on the current branch. Use it for quick edits or when a tool insists on the real path.

Managed worktrees inherit the env files you list in Settings › Workspaces (for example .env.local), and each gets a unique development port from the configured range so two dev servers never collide. Finished worktrees are cleaned up within the dispatch cleanup budget.

Bringing the work back

When a thread's branch is ready, Ship pushes it and opens a pull request, or Land merges it into your base branch from the app with a 24-hour undo.