Definition#

A session is the conversation and execution history for agent work inside a workspace. It records prompts, agent output, tool activity, and the resulting messages.

What sessions are for#

• Start a task with context and instructions.
• Continue work after reviewing an intermediate result.
• Keep the reasoning trail attached to the workspace.
• Understand why a change was made before committing it.

How to use sessions well#

Keep prompts concrete. Ask the agent to verify with a specific test, command, or manual check. If the agent gets stuck, give more product context in the same session so the history stays complete.

Review habit#

Read the session output and the diff together. The session explains intent; the diff proves what actually changed.