One agent, one session

Each agent maintains a single Claude session. All your messages, the agent's replies, tool calls, file reads — one continuous thread.

Why one session

Continuity. The agent remembers what you said three days ago, what it decided, what you corrected. No re-onboarding every conversation.

When a reset is needed

Resetting starts a fresh session. The previous session is summarized; the summary is prepended as the first message of the new session, so context survives.

Cubicle flags the agent needs_reset when you change a field that rewrites the system prompt:

• role
• model
• extra_prompt

Until you reset, the agent keeps replying with the old prompt — the new one isn't live yet.

The banner

When needs_reset is set, a banner appears at the top of the chat: "Profile changed. Reset session to apply." Click reset and the new session starts.

Manual reset

You can also reset any time without changing the profile — right-click the agent → "Reset session". Useful if a long thread has gotten messy.

What's preserved

• Memory (/mnt/memory/)
• Desk files
• Todos
• Schedules
• Meeting history

Only the chat session itself is rolled over, with a summary stitching old to new.

See Profile editing for what triggers the flag.