Every time you launch Geoff Code it records the full conversation — messages, edits, approvals, and plan state — as a session. Sessions let you pick up exactly where you left off instead of re-explaining context. They are stored under ~/.geoff and scoped to the working directory you launched from.

​
Start a new session

Running geoff with no session flags always begins a fresh session for the current directory:
Inside the TUI you can start a clean session at any time with /new.

​
Resume a previous session

Geoff Code offers a few ways back in, depending on how precisely you want to target a session.

​
Continue the most recent

-C (or --continue) resumes the latest session for the current working directory — the fastest way back into yesterday’s work:

​
Pick a session interactively

Pass -S (or --session) with no ID to open an arrow-key picker showing every session for this directory, with titles and timestamps:

​
Resume a specific session

If you know the ID, pass it directly:
-r, --resume is a hidden alias for -S, --session and behaves identically. Both accept an optional ID.

​
Switch sessions mid-run

You don’t have to restart to change context. Inside the TUI, /sessions lists every session so you can jump to another one, and /new spins up a fresh one without leaving the program.

​
What gets persisted

A session captures more than just the message transcript, so resuming restores your whole working state:
  • Conversation history (your prompts and the agent’s responses)
  • Approval decisions and permission mode (including yolo / auto)
  • Plan mode status
  • Subagent instances and their isolated context
  • Extra workspace directories added during the session

​
Managing context

Long sessions accumulate tokens. Geoff Code shows current context usage in the status bar, and gives you slash commands to keep it lean:
  • /compact — summarize the conversation so far into a compact form, freeing up context while preserving intent.
  • /clear — drop the conversation context entirely and start fresh (alias for /new).
  • /undo — revert the last change the agent made.
  • /fork — branch the current session into a new one, keeping the existing one intact.

​
Export a session

Export a complete session — transcript, metadata, and diagnostics — as a ZIP archive for sharing or bug reports. Use the export subcommand:
By default the active global diagnostic log (~/.geoff/logs/geoff-code.log) is bundled in. Pass --no-include-global-log to leave it out. See the Command Reference for full details.

​
Next

Config Files

Set defaults for models, permissions, and plan mode.

Command Reference

Every session-related flag in one place.