# Docs

Documentation for Dots — every page is a row in the Docs Dotabase.

## Agent surface

The Dots API serves this corpus to agents directly, alongside every other published Dotabase:

- MCP: `POST https://app.mydots.ai/api/v1/public/mcp` — the Model Context Protocol endpoint for the public plane.
- CLI: `dots public search | graph | rows | get | manifest` — the same plane from a terminal.
- REST: `https://app.mydots.ai/api/v1/public/publications/{slug}/...` — the public read plane both of the above are built on.

## start

- [Connect Your Agent](/envelopes/connect-your-agent.md): Point any MCP-capable agent at your Dotabases so it can read and write your knowledge as it works.
- [Install The CLI](/envelopes/install-the-cli.md): The dots CLI ships inside the Dots desktop app — install the app and the CLI comes with it; on Windows the installer also puts dots on your PATH.
- [Quickstart](/envelopes/quickstart.md): You already have the IAGREED plugin. Paste one prompt into Claude Code or Codex: your agent brings Dots up on the posture you pick and runs you through first run.
- [Quickstart: Agents](/envelopes/quickstart-agent.md): Connect an MCP-capable agent to your workspace, scope what it may do, and give it a credential of its own.
- [Quickstart: Developers](/envelopes/quickstart-developer.md): Evaluate Dots from the terminal: install the CLI, create a Dotabase, write and read rows, and connect them into a graph.
- [Quickstart: Self-hosting Dots](/envelopes/quickstart-self-host.md): Pick a hosting posture, bring the self-contained stack up, point the CLI at your own instance, and prove it answers an authenticated read.
- [Quickstart: Teams](/envelopes/quickstart-team.md): Invite your team into a workspace, give each role only the Dotabases it needs, and read back who did what.
- [What Is Dots?](/envelopes/what-is-dots.md): Dots is a knowledge platform built on one primitive, the Dotabase: a typed collection of rows you read as a table, walk as a graph, or hand to an agent as context.

## concepts

- [Access](/envelopes/access.md): The per-tenant identity and authorization plane — the RBAC module covering principals, roles, grants, credentials, approvals, and audit within one company.
- [Access And Tenancy](/envelopes/access-and-tenancy.md): Every operation runs inside one company, governed by principals, roles, grants, credentials, entitlements, approvals, and an audit ledger.
- [Access Control](/envelopes/access-overview.md): How Dots decides whether an actor may perform an operation: the tenant boundary, principals covering people and agents alike, permission atoms and the four system roles, per-Dotabase grants, credential scoping, approvals, and the audit ledger.
- [Admin Overview](/envelopes/admin-overview.md): Decide who may do what inside a workspace, and run the instance that workspace lives on.
- [Agent Envelope](/envelopes/agent-envelope.md): Agent Envelope — the YAML-frontmatter-plus-Markdown row block shared by CLI, MCP text, and docs export.
- [App Shell](/envelopes/app-shell-overview.md): The frame every module renders inside: the five regions of an authenticated page, how workspace scoping reaches the routes, the command palette's three modes, the Settings overlay, and notifications.
- [Behavior](/envelopes/behavior.md): A bound, per-Dotabase extension that runs automatically on a row's lifecycle — the platform's mechanism for making a Dotabase *do* something rather than merely store rows.
- [How Chat Works](/envelopes/chat.md): Chat assembles each turn from your Dotabases, your HUMAN.md, and the tools you enable, then dispatches it to your chosen model.
- [Chat Overview](/envelopes/chat-overview.md): Conversations held against your own workspace: two families of model, five modes, a context aperture you set per message, and a transcript that lands back in your workspace as a row.
- [Chip (AI co-worker)](/envelopes/chip-ai-co-worker.md): The AI co-worker inside Dots — the product's in-app assistant persona, with hands. Chip works inside the user's actual workspace through the `dots` CLI: it searches Dotabases, writes rows, manages tasks, and cites what it retrieved.
- [CLI Overview](/envelopes/cli-overview.md): Drive your whole workspace from a terminal, a script, or a coding agent's shell.
- [Context Cabinet](/envelopes/context-cabinet.md): The foundational Dotabase holding every captured file and document — raw, searchable, and the default destination for anything with no better home. Rows are `CTX-N`; it is usually just called "the Cabinet".
- [Conversations](/envelopes/conversations-overview.md): How live chat turns and imported coding-agent sessions land in one seeded Dotabase, what a conversation row carries, and how to read one back from the CLI, search, or the app.
- [DIIICE](/envelopes/diiice.md): DIIICE is the six-way taxonomy every DOT is classified into: Data, Intelligence, Instructions, Ideas, Context, and Examples.
- [DIIICE: Context](/envelopes/diiice-context.md): The DIIICE type for background, circumstances, preferences, or situational framing that situates other knowledge.
- [DIIICE: Data](/envelopes/diiice-data.md): The DIIICE type for raw facts, records, measurements, or datasets with no interpretation layered on top.
- [DIIICE: Examples](/envelopes/diiice-examples.md): The DIIICE type for concrete instances, demonstrations, samples, or cases that illustrate a point.
- [DIIICE: Ideas](/envelopes/diiice-ideas.md): The DIIICE type for proposals, hypotheses, concepts, or possibilities not yet acted on or verified.
- [DIIICE: Instructions](/envelopes/diiice-instructions.md): The DIIICE type for directives, procedures, steps, rules, or commands telling someone how to act.
- [DIIICE: Intelligence](/envelopes/diiice-intelligence.md): The DIIICE type for synthesized insight, analysis, conclusions, or judgments derived from data.
- [DIIICE Glossary](/envelopes/diiice-term.md): DIIICE — the six knowledge types a DOT is classified into: Data, Intelligence, Instructions, Ideas, Context, Examples.
- [DOT](/envelopes/dot.md): DOT — the atomic unit of knowledge in Dots: a single typed row that is also a node in the knowledge graph.
- [Dotabase](/envelopes/dotabase.md): A structured, searchable collection of DOTs — the platform's core container, and the single foundational data primitive Dots is built on. Roughly "a database of DOTs", but with an AI-native shape: schema, saved views, bound behaviors, an embedding path, and its own Operating Manual telling agents how to use it.
- [How Dotabases Work](/envelopes/dotabases.md): A Dotabase is the platform's foundational primitive — typed rows with a schema, behaviors, edges, views, and an Operation Manual.
- [Dotabases Overview](/envelopes/dotabases-overview.md): The one primitive everything in Dots is built on: typed rows under a closed schema, enriched by behaviors, connected by edges, and read through views by you, the CLI, and your agents.
- [Dots](/envelopes/dots.md): The company and the platform — a knowledge platform building the infrastructure layer for human intelligence, built on a single foundational data primitive: the Dotabase.
- [DOTs And The Knowledge Graph](/envelopes/dots-and-the-knowledge-graph.md): Every row is a DOT — an atomic unit of knowledge — and typed, directed edges connect them into a knowledge graph.
- [Edge](/envelopes/edge.md): Edge — a typed, directed link between two rows, drawn by an author or discovered by a behavior.
- [General Overview](/envelopes/general-overview.md): The workspace itself: the frame every module renders inside, the search that spans it, and the companion that runs on your own machine.
- [HIM](/envelopes/him.md): Human Intelligence Model — the proprietary large language model Dots is building, trained on human intelligence rather than on the public web.
- [HUMAN.md](/envelopes/human-md.md): A document describing who a person is in the context of the work — their role, what they own, what they defer, their voice, their strong suits, and how to operate with them. It is read at session start so an agent works with the person rather than at them.
- [MCP Overview](/envelopes/mcp-overview.md): Give a coding agent supervised access to your workspace over the Model Context Protocol.
- [Memory Bank](/envelopes/memory-bank.md): The foundational Dotabase holding episodic memories — durable observations, decisions, rationale, and failures worth keeping across sessions. Rows are `MEM-N`.
- [Dotabase Operation Manual (DBOM)](/envelopes/operation-manual.md): Dotabase Operation Manual (DBOM) — the per-Dotabase purpose, authority, and judgment that tells a person or an agent how that Dotabase is meant to be used.
- [Power-Up Playbook](/envelopes/power-up-playbook.md): A curated knowledge index that scopes what a capability retrieves. Abbreviated **PUP**; rows are `PUP-N`.
- [Repo Graph Overview](/envelopes/repo-graph-overview.md): Map a codebase into your workspace as rows and typed edges, then ask it who calls what, what breaks if you change something, and why a symbol exists.
- [SDK Overview](/envelopes/sdk-overview.md): Build on Dots from your own TypeScript: a typed client, typed errors, and the seams that add what the platform did not ship with.
- [Space](/envelopes/space.md): A container that groups Dotabases inside a workspace — the organizing layer one level above the Dotabase.
- [Superpower](/envelopes/superpower.md): An invokable capability stored as a row and callable from Chat, the CLI, MCP, or the API. Rows are `SPWR-N`.
- [Foundational And Internal Dotabases](/envelopes/the-foundational-six.md): Four canonical foundational Dotabases ship alongside always-seeded internal Dotabases such as Context Cabinet and Glossary.
- [View](/envelopes/view.md): View — a saved lens over a Dotabase's rows, with its own type, filters, sorts, and grouping.
- [Views And Lenses](/envelopes/views-and-lenses.md): The same rows, seen many ways — table, board, gallery, calendar, graph, and dashboard views, each a saved lens over your data.

## reference

- [Conversation Insights Dashboard](/envelopes/changelog-conversation-insights.md): The Conversations Dotabase now seeds a thirteen-widget Conversation Insights dashboard covering conversation volume, token spend, cache efficiency, and activity over time.
- [Cursor Conversation Import](/envelopes/changelog-cursor-import.md): Cursor joins Claude Code and Codex as an importable coding agent, with per-folder consent that fails closed and metadata-only detection before you approve.
- [First-run Setup Assistant](/envelopes/changelog-setup-assistant.md): A first-run Setup Assistant now walks a fresh install through nine fixed steps — license, workspace provisioning, agent detection, a guided plugin install, the concierge run, and three reveals.
- [dots coding-agents and dots git](/envelopes/cli-coding-agents-and-git-commands.md): Every dots coding-agents and dots git subcommand — 17 commands with their arguments and options, read from the CLI command tree.
- [dots connections and dots sync](/envelopes/cli-connections-and-sync-commands.md): Every dots connections and dots sync subcommand — 21 commands with their arguments and options, read from the CLI command tree.
- [dots dotabases, dots row-templates, and dots spaces](/envelopes/cli-dotabases-commands.md): Every dots dotabases, dots row-templates, and dots spaces subcommand — 51 commands with their arguments and options, read from the CLI command tree.
- [dots events tail](/envelopes/cli-events-command.md): The live-event reader — dots events tail prints every frame one of the three server-sent event streams carries and runs until stopped.
- [dots marketplace and dots plugin](/envelopes/cli-marketplace-and-plugin-commands.md): Every dots marketplace and dots plugin subcommand — 38 commands with their arguments and options, read from the CLI command tree.
- [dots mcp, dots repo, and dots graph](/envelopes/cli-mcp-and-repo-commands.md): Every dots mcp, dots repo, and dots graph subcommand — 30 commands with their arguments and options, read from the CLI command tree.
- [CLI Reference](/envelopes/cli-reference.md): The dots CLI's workspace families front the platform's data, RBAC, Chat, and routes, alongside machine-local command families.
- [dots rows, dots edges, and dots pages](/envelopes/cli-rows-and-edges-commands.md): Every dots rows, dots edges, and dots pages subcommand — 53 commands with their arguments and options, read from the CLI command tree.
- [dots sandbox](/envelopes/cli-sandbox-command.md): The throwaway-tenant lifecycle — dots sandbox create provisions a fully seeded disposable workspace, and dots sandbox destroy tears it down through a hard-scoped cascade delete.
- [dots search and dots tags](/envelopes/cli-search-and-tags-commands.md): Every dots search and dots tags subcommand — 7 commands with their arguments and options, read from the CLI command tree.
- [dots settings, dots files, and dots human-md](/envelopes/cli-settings-and-files-commands.md): Every dots settings, dots files, and dots human-md subcommand — 12 commands with their arguments and options, read from the CLI command tree.
- [dots wait](/envelopes/cli-wait-command.md): The blocking wait primitive — dots wait blocks until one condition occurs, prints the occurrence, and exits, always under a deadline.
- [dots workspaces, dots account, and dots providers](/envelopes/cli-workspaces-and-account-commands.md): Every dots workspaces, dots account, and dots providers subcommand — 24 commands with their arguments and options, read from the CLI command tree.
- [llms.txt](/envelopes/llms-txt.md): An llms.txt index at the site root lists the agent surface and then every page by type, each linked to its exported envelope with its summary.
- [MCP Tools](/envelopes/mcp-tools.md): The MCP server has 321 built-in tools across route-backed and locally handled paths; default connections receive the complete granted set, while a launcher opting in with --defer-tools starts with core tools plus discover_tools.
- [REST API Overview](/envelopes/rest-api-overview.md): Every public workspace capability is a typed route under /api/v1, documented in an OpenAPI document served at GET /api/v1/openapi.json.
- [Row Envelope Format](/envelopes/row-envelope-format.md): A row envelope is the shared YAML-frontmatter-plus-Markdown record block; each transport wraps or omits DBOM context differently.

## how-to

- [Automate Work With Chat Automations](/envelopes/automate-work-with-chat-automations.md): Turn a prompt you keep retyping into a scheduled run: start from a template or from scratch, set a cron schedule and timezone, and read the run history each fire leaves behind.
- [Build A Plugin](/envelopes/build-a-plugin.md): Author a plugin in a directory of your own, declare the seam it contributes and the authority it asks for, run it against a local daemon, and install it on your own instance — without editing a line of Dots source.
- [Build And Publish A Plugin](/envelopes/build-and-publish-a-plugin.md): Scaffold a plugin in your own repository, run it against a local daemon, install it on your instance under a sandboxed grant, and submit it to the Marketplace only when you choose to.
- [Connect An Agent Via MCP](/envelopes/connect-an-agent-via-mcp.md): Register the dots MCP server with Claude Code, Claude Desktop, or Cursor so your agent can query and write your Dotabases.
- [Create A Dotabase](/envelopes/create-a-dotabase.md): Name a Dotabase, give it a schema, and add your first rows — from the CLI or the app.
- [Define Permission Roles](/envelopes/define-permission-roles.md): Build a named role from permission atoms, assign it to people or agents, narrow it to a single Dotabase with a grant, and park sensitive atoms behind an approval.
- [Give Chat The Right Context](/envelopes/give-chat-the-right-context.md): Use the Context Picker to set what a turn is allowed to see: which Dotabases and memories are open, which HUMAN.md applies, whether it can reach the web, and how to wall a turn down to a curated set of rows.
- [Import Your Coding-agent Conversations](/envelopes/import-coding-agent-conversations.md): Bring your local Claude Code, Codex, and Cursor session history into the Conversations Dotabase: consent per folder, back-fill once, then tail for new sessions.
- [Import From Markdown](/envelopes/import-from-markdown.md): Bring a folder of Markdown files into a Dotabase with one command — frontmatter becomes properties, and re-runs stay idempotent.
- [Ingest A Repository](/envelopes/ingest-a-repository.md): Parse a local checkout into files, symbols, and structural edges, re-run it incrementally as the code moves, and read back whether the graph is current.
- [Install From The Marketplace](/envelopes/install-from-the-marketplace.md): Find a listing, read its trust summary before committing, install it into your workspace with the variables it needs, and keep it current afterwards.
- [Invite Your Team](/envelopes/invite-your-team.md): Send a workspace invitation with the roles it should land on, hand over the one-time token, track who has not accepted yet, and revoke an invite that should not be used.
- [Issue Scoped Agent Credentials](/envelopes/issue-scoped-agent-credentials.md): Give an agent a principal of its own, grant it exactly the Dotabases it needs, and issue a token narrowed to specific permission atoms with an expiry you can revoke.
- [Publish A Dotabase To The Web](/envelopes/publish-a-dotabase-to-the-web.md): Publish selected views of a Dotabase as an anonymous public page, share the link, and read the same publication back over the public MCP, CLI, and REST surfaces.
- [Query The Code Graph](/envelopes/query-the-code-graph.md): Ask an ingested repository who calls a symbol, what it calls, what breaks if it changes, how two nodes connect, what sits next to it, what a commit range changed, and why a symbol exists — from the CLI or from an agent over MCP.
- [Run The Companion](/envelopes/run-the-companion.md): Start, inspect, stop, and supervise the Dots companion, including its durable sign-in startup registration.
- [Search Your Workspace](/envelopes/search-your-workspace.md): Find anything you can read across every Dotabase: open the command palette, narrow with scope and lens, jump straight to a row by its id, and run the same search from the terminal.
- [Self-host Dots](/envelopes/self-host-dots.md): Run Dots with one command: bundled Postgres, bundled object store, in-process identity plane, and secrets generated on first boot.
- [Self-host Telemetry](/envelopes/self-host-telemetry.md): Export OpenTelemetry traces and metrics from a self-hosted instance to your own OTLP collector by setting one endpoint variable.
- [Start A Chat Conversation](/envelopes/start-a-chat-conversation.md): Open Chat, choose between a direct model and a local coding agent, set the mode and workspace, send your first message, and keep the conversation once it is done.

## tutorials

- [Your First Dotabase](/envelopes/your-first-dotabase.md): A hands-on walkthrough: build a small Dotabase from scratch, add rows, connect them with edges, and view them as a graph.