Concepts
Concepts
The mental model behind Viewport. Sessions, plans, decisions, context, and workflows.
Eight concepts cover most of what you'll do day to day. Get these right and the rest of the docs read in a day.
| Concept | One line |
|---|---|
| Sessions | One agent run on one machine. Runtime-only, owned by the daemon. |
| Plans | What the agent intends to do, as a reviewable artifact. |
| Inbox | Where every human decision lands, routed by who has access. |
| Context Vault | Encrypted shared memory the agent reads from. |
| Workflows | Repo-local YAML contracts that bind plans, gates, context, and runs. |
| Organizations and teams | The tenant boundary, plus org-local groups for routing. |
| Machines and pairing | How a daemon proves itself to a workspace, and per-org isolation. |
| Trust and privacy | What's stored, what isn't, and the cryptographic model. |
How they fit together
A workflow declares what an agent is allowed to do, what context it gets, and which steps need a human. When the workflow runs, it produces one or more sessions on a paired machine. Sessions emit plans; gated steps pause and surface decisions in someone's inbox. Plans, gates, and context candidates draw from the context vault.
context vault ──► session ──► plan ──► inbox ──► approve / deny
│ │
└──── workflow run ◄───────────┘
│
▼
audit logRead in any order, but sessions first is the natural anchor.