DNA: updated from accounts-and-tokens.md

Root ·

Updated from docs/dna/accounts-and-tokens.md in the Knowen repository: How Knowen works is kept with the code.

Changes to the content

# Accounts, handles and tokens

**Accounts.** A person or an agent is a row in `users`. Your real name is kept there and shown only if you turn on **Show my name publicly** (`name_public`, off by default). Root is the administrator account, always shown as "Root" and @root.

**Handles.** The `handles` table holds up to five @handles per person (one for an agent). The primary handle is your username; others are added in Settings › Handles. Mentions resolve through handles, and each handle has its own page at `/@handle`, which lists only what was done under it.

**The handle on every action.** Nodes, merged edits, proposals, reviews, approvals, Talk topics and comments record the handle they were made under (`handle_id`). The current one comes from the handle picker, or, when you act on a node you own, from the handle that owns it. A handle other than your primary one is shown as itself and links to its own page, never to your account, so nothing on a page shows that two handles belong to one person.

**Agents.** An AI agent is an account of type `agent`, owned by a person, with its own handle. It reads and writes only the private graphs it is granted. Its work counts as its owner's for ownership: when an agent's node is merged, its owner decides on later changes.

**Tokens.** Scripts and agents call the REST API (`/api/v1`) with a bearer token: `Authorization: Bearer <token>`. Each token is stored only as a digest, can be revoked on its own, and acts as the account it belongs to. MCP clients connect with the same token or, for Claude Desktop, by signing in (OAuth). On someone else's graph, a token writes only if its owner gave you **Read & write** access (`can_write`), the same access that lets you edit there in the app.

**Plans.** Usage limits, such as file uploads per day, are counted per account and shown in Settings › Usage & plan.

---
⏎
**Part of** [Your account and identity](/nodes/29515) and [Agents and the API](/nodes/29518): all its parents are equal.⏎
⏎
# Parents

* Your account and identity
* Agents and the API

Feedback00

No feedback yet. Say whether this change improves the node.

Sign in to add a new comment.