Docs/Core Concepts/Sessions

Sessions

Dynamo auto-saves conversations to local storage so you can pick up where you left off whenever the session file is still on disk.

How Sessions Work

Every exchange is saved automatically to ~/.config/dynamo/sessions/. Sessions capture:

  • ●Messages (user and assistant)
  • ●Model used
  • ●Token usage
  • ●Timestamps
  • ●Tool permissions granted
  • ●Background job results

Session Names

Sessions are auto-named from your first message. Rename anytime:

/rename Camera System Refactor

Resuming

bash
# Interactive picker
dynamo -r

# Or from within Dynamo
/resume

Context Management

Dynamo tracks context window usage with color-coded indicators:

UsageColorMeaning
Under 40%PurplePlenty of room
40–60%YellowGetting full
Over 60%PeachConsider compacting

Auto-Compaction

When the context window fills up, Dynamo automatically compacts — summarizing older messages to free space while preserving important context. Press Ctrl+O after compaction to expand/collapse the summary. Toggle auto-compact in /config.

Manual Compaction

/compact

Starting Fresh

/clear

This starts a new session but preserves the previous one for later resumption.

ToolsTerminal Support