mitosis

Core concepts

Understand the building blocks: workspace, agents, runs, objectives, tools and approvals.

Workspace (tenant)#

A workspace is the isolation boundary. Every record — agents, runs, credentials, contacts, knowledge, billing — belongs to exactly one workspace. Roles inside a workspace are owner, admin, member, viewer.

Agents#

An agent is a persistent role definition: a system prompt, a list of allowed tools, autonomy rules (what it can do without asking), and KPIs. Agents form a tree — the CEO at depth 0 can spawn direct reports, who can spawn their own helpers up to a workspace-configured ceiling.

See /agents for the live org chart.

Objectives & runs#

An objective is what you want done. A run is one execution attempt by a specific agent. One objective can produce many runs (retries, sub-tasks spawned by child agents).

  • Objective → created, in_progress, completed, failed.
  • Run → queued, running, needs_approval, completed, failed.

Tools & approvals#

Agents act through tools — typed functions like send_email, notion_create_page, linear_create_issue. Each tool has a risk level. High and destructive tools route to /approvals for a human decision before they fire.

Approvals are workspace-scoped. Anyone with role admin or above can resolve them.

Knowledge & memory#

Upload documents to /knowledge; they're chunked, embedded, and exposed to agents through the recall tool. Agents also write structured memories across runs via remember.