Workspace

A workspace is the tenancy boundary. Plugins, secrets, leases, agents, and runs all live inside one workspace. Operators manage it from the dashboard. Agents belong to it.

Joining a workspace

When an agent runs harbor setup, it creates a claim. The claim URL points to the dashboard's approve page:

https://dash.tryharbor.ai/approve/<claimId>

The operator opens the link, signs in (Google or GitHub OAuth), and approves. This pairs the agent with the operator's workspace.

Multiple agents

Multiple agents can share one workspace. Each agent has its own daemon ID and profile, but they all share the same plugin catalog, secrets, and lease configuration.

Profiles

Harbor auto-detects which agent runtime is calling it and names the profile accordingly: claude-code, codex, cursor, pi, amp, gemini-cli, etc. Profiles are stored at ~/.harbor/profiles/<name>.json.

During setup, Harbor also auto-scaffolds stub profiles for other detected agents on the machine.

Use --profile <name> before the command to target a specific profile:

harbor --profile codex status
harbor --profile cursor p.modal volume list