Workspaces & projects
A workspace is your organization's space in fbuild. Projects are the repositories your agents work on, discovered from your connected machines.
Workspaces #
A workspace is your organization's space in fbuild — its members, machines, projects, and tasks. If you belong to more than one, you can switch between them (Slack-style) from the switcher, and jump directly with ⌘1…9. Notifications from every workspace collect in one tray.
Each workspace keeps its own session, so switching cleanly re-connects you to the right backend.
Projects #
A project is a repository your agents can work on. Projects come from the machines you connect: once a runner is online, the repositories on that machine become available to select when you create a task.
- A project can be marked as part of your workspace (a member project) or surfaced as a candidate you can opt in.
- When you create a task you pick the project (and can set a focus — the repositories the agent should load into context).
To make projects show up, you first connect a machine — see Connecting a machine.
A deeper Team → Workspace → Project hierarchy (with per-workspace isolation and custom domains) is on the roadmap — see Where fbuild is going.