Documentation

Workspaces

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

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 AO-managed directory with no branch or PR operations.

AO 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.