Storage
SDK Session Layout
Why local SDK Agent sessions live under .downcity/agents/<agentId>/...
SDK Session Layout
Local SDK Agent sessions are persisted under:
<projectRoot>/.downcity/agents/<agentId>/sessions/<sessionId>/messages/messages.jsonlWhy agentId exists in the path
Because several SDK Agents may coexist inside the same project directory.
agentId isolates their session data.
What you will see there
messages.jsonl- session metadata
- archive directories
When you debug multiple sessions or multiple agents, this directory layout becomes very important because it defines how data stays isolated between different execution units.