Orchestrator.incDocs

Workspaces

Git worktrees for repositories and Orchestrator-managed directories for Scratch projects.

View on GitHub

Workspace behavior follows the registered project kind:

Project kindSession workspace
Git repositoryA fresh Git worktree and branch.
Multi-repository workspaceA root worktree with registered child repositories materialized for the session.
ScratchAn Orchestrator-managed directory with no branch or PR operations.
Standalone workerA projectless Orchestrator-managed directory; no project, issue, branch, or PR options.

Orchestrator does not currently offer a full-clone workspace selector. Register a project with ao project add, then let the daemon route workspace operations from its project record.

Workspace cleanup is conservative: killing a session does not force-delete a dirty registered worktree. Use ao session cleanup --dry-run to inspect eligible terminated sessions.