Previews are where deployment artifacts and visual review come together. Annotations make that feedback actionable instead of vague.
The previews surface combines live sprite VM previews with visual annotations. It is the feedback loop between a deployed surface and the operator workflow.
What the UI shows
/previews renders sprite VM preview records with deployment context and review metadata.
Visual annotations are normalized into the same feed so operators can review deployments and feedback in one place.
Each item is normalized into the same list UI and can be filtered by type.
Source: apps/app/src/app/previews/page.tsx
Preview deployment path
The CLI exposes sprite preview orchestration through agents preview.
agents preview
agents preview --project my-app
agents preview status
agents preview stopThe preview command is explicitly documented as:
- init + sync + start
- optional Doppler project injection
- optional screenshot capture
Source files:
-
packages/cli/src/cli/commands/preview/** -
packages/cli/src/lib/preview/**
Annotation path
| Function | Purpose |
|---|---|
agentSystem.annotations.list | Read annotations into the dashboard |
agentSystem.annotations.upsert | Update annotation status, intent, and severity |
http.ts | Mount Agentation-compatible HTTP routes |
Source files:
-
packages/backend/convex/agentSystem/annotations.ts -
packages/backend/convex/http.ts -
packages/backend/convex/agentSystem/previews.ts
Severity and status
Operator guidance
Use previews when you need live artifact review and annotations when you need precise feedback tied back to a session, thread, or preview artifact.