SyndicateDocs

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