Configure Studio
Storage and Persistence
Understand Studio's local SQLite storage for sessions, traces, and pipeline logs.
Studio creates a local SQLite store by default. It stores sessions, runtime messages, transcript entries, traces, and pipeline logs for local inspection.
Default Path
By default, Studio writes to:
.anvia-studio/anvia-studio.sqliteSet ANVIA_STUDIO_DB when you want a specific file.
ANVIA_STUDIO_DB=.data/studio.sqlite pnpm tsx studio.tsAION_STUDIO_DB is also read as a compatibility fallback.
What Gets Stored
| Data | Purpose |
|---|---|
| Sessions | Local conversations for one registered agent |
| Messages | Runtime history used when continuing a session, stored as message and message-part rows |
| Transcript entries | UI-friendly run output with messages, reasoning, tool calls, approvals, and questions |
| Traces | Generation and tool observations captured during runs |
| Pipeline logs | Metadata-only audit events for Studio pipeline runs |
Sessions and Traces
When storage is available, Studio enables both sessions and traces capabilities. Runs with a sessionId load the stored messages as history and append the final messages after the run completes.
curl http://localhost:4021/config{
"capabilities": {
"sessions": { "enabled": true },
"traces": { "enabled": true }
},
"unsupportedCapabilities": []
}