Skip to content
AlumiaDocs

Search docs

Find pages, headings, and concepts. Press ⌘K or Ctrl+K to toggle.

Projects and workspaces

Organize work into workspaces and projects, each with their own canvas, agents, and shared context.

Open in ChatGPTOpen in Claude

Alumia is multi-tenant by design. Everything lives under an organization, and within an organization you have workspaces and projects.

Organizations

Every signup creates an organization automatically. All data is row-level isolated in PostgreSQL — no cross-org reads, even by mistake. You invite teammates and assign roles from the Settings page.

Workspaces

Workspaces are how you group projects and members within an org. Most orgs only need one workspace; larger orgs use them to carve out departments. Ala (the default agent) is visible across every workspace.

Projects

Projects are the unit of work. Each project has:

  • A canvas
  • Its own agents
  • Files, knowledge, memories, datasets, and tasks
  • A primary workspace plus optional shared workspaces (project_workspaces)
  • Project-scoped file browsing rooted at a protected project folder

When in doubt, one project per "thing you're trying to ship." A project is cheap to create and easy to share.