Workspace Registry and Operations

Resolve, connect, initialize, list, synchronize, and govern one canonical workspace identity across projects and consumers.

Workspace commands operate on identity and membership. They do not infer a new workspace independently for each terminal, IDE, or agent.

npx workspai workspace list --json
npx workspai workspace registry --json

workspace connect binds a project to an existing workspace. workspace init establishes the workspace boundary. workspace sync reconciles registered projects and managed workspace metadata while preserving authored content.

npx workspai workspace connect --json
npx workspai workspace sync --json

Portable project metadata identifies the relationship; machine-local links resolve the actual path. A consumer must not persist a developer's absolute path as portable source or silently fall back to the default workspace after an explicit binding fails.

Policy and foundation commands manage declared workspace behavior. Model then observes that durable state; registry mutation is not itself an intelligence fact.

Command reference: workspace, workspace list, and workspace sync.