First workstation#
A workstation groups one repository with durable provider sessions and a tmux presentation.
Before you start#
- Syndicate is installed and Doctor passes.
- The repository exists and is inside an allowed root.
- Git status is understood before new worktrees are created.
- At least one agent CLI is installed and authenticated.
Create the workstation#
syndicate workstation /srv/code/project
Open the dashboard with a short-lived, single-use URL:
syndicate dashboard --no-open
Open the exact printed URL in the intended browser. Create a session, select a provider, confirm the absolute repository path and begin read-only.
Verify#
syndicate workstation status
syndicate session list
git -C /srv/code/project worktree list
The workstation should report running, the session should appear once, and any writable task should have its own Syndicate worktree rather than editing the primary checkout.
If it does not work#
| Symptom | Check | Recovery |
|---|---|---|
| The workstation is created but no session starts | syndicate doctor |
See Start with doctor |
| An agent is reported unavailable | Whether its CLI is installed and on the resolved path | See An agent is unavailable |
| A pane opens and closes immediately | tmux, then the agent executable | See A pane or session will not start |
| The repository cannot be prepared | Whether the path is a git repository the syndicate user can read |
Worktrees are created from it; an unreadable repository fails late |