# Mandala Docs

> Product and engineering documentation for Mandala's permissioned agents, connected data, Sandbox, approvals, and controlled execution.

## Docs

- [Development](https://docs.mandala.md/development.md): Run the stack, build the terminal, work with migrations, test agents, and preserve safety boundaries.
- [Agents](https://docs.mandala.md/guides/agents.md): Define, validate, test, activate, pause, and restore permissioned Mandala agents.
- [Inbox and approvals](https://docs.mandala.md/guides/inbox-and-approvals.md): Review recommendations, evidence, drafts, decisions, and controlled execution outcomes.
- [Sandbox](https://docs.mandala.md/guides/sandbox.md): Test agents against real workspace data without committing business side effects.
- [Mandala overview](https://docs.mandala.md/index.md): How Mandala turns connected business data into permissioned, reviewable agent work.
- [Quickstart](https://docs.mandala.md/quickstart.md): Run Mandala locally, sign in, test an agent, and review the resulting work.
- [CLI reference](https://docs.mandala.md/reference/cli.md): Interactive and scripted commands for authentication, agents, Sandbox, and approval work.
- [API reference](https://docs.mandala.md/system/api.md): Authenticated control-plane route groups, worker endpoints, response contracts, and extension rules.
- [Architecture](https://docs.mandala.md/system/architecture.md): How the CLI, control plane, compiler, runtime, connectors, Context Engine, and workers fit together.
- [Authentication and roles](https://docs.mandala.md/system/auth.md): Web auth, hosted CLI authorization, secure session storage, workspace roles, and invitations.
- [Connectors and workspace data](https://docs.mandala.md/system/collections.md): How connectors, capability grants, catalog mappings, sync, health, and freshness work.
- [Data model and security boundaries](https://docs.mandala.md/system/data-model.md): Workspace ownership, major database domains, versioning, RLS, and private workflow records.
- [Context Engine](https://docs.mandala.md/system/imports.md): Governed indexing, bounded retrieval, provenance, citations, and provider fallback.
- [Operations and release checks](https://docs.mandala.md/system/operations.md): Environment, workers, checkpoints, connector readiness, observability, and release verification.