Sessions

A session is your ongoing conversation with Toporic. Every message you send, every response the agent gives, and every action it takes is saved — so you can pick up right where you left off, even days later.

What sessions do for you

• Pick up where you left off — close your terminal, grab lunch, come back. Your conversation and context are preserved.
• Resume across reboots — restart your machine and continue the same session.
• Keep project context alive — the agent remembers what files it edited, what tests ran, and what decisions were made.
• Switch between projects — each workspace has its own sessions. Jump between projects without losing context.

Starting a new session

Just run toporic. A new session starts automatically. It’s saved to disk so you can come back to it later.

# Start a fresh session
toporic

# Start a session with a goal (one-shot, exits when done)
toporic --goal "Add unit tests for the auth module"

Resuming a session

# Resume the most recent session
toporic --resume

# Resume a specific session by its ID
toporic --resume 550e8400-e29b-41d4-a716-446655440000

When you resume, the agent replays your conversation history and restores the full context — it knows what you were working on, what files were modified, and what tasks were in progress.

Session commands in the TUI

While in the TUI, you can manage sessions with slash commands or keyboard shortcuts:

Action	Slash command	Shortcut
Start new session	/session --new	Ctrl+N
List past sessions	/session list	(none)
Switch to a session	/session <id>	(none)

Starting a new session clears the current conversation and gives the agent a fresh start. The old session is still saved and can be resumed later.

Session list

Type /session list in the TUI to open the session picker. You’ll see your recent sessions with timestamps, mode, and the last message preview. Use ↑/↓ to navigate, Enter to resume a session, or Esc to cancel.

Running without saving

If you don’t want a session to be saved — for one-off questions or temporary exploration — use the --no-persist flag:

toporic --no-persist

The conversation runs entirely in memory and is discarded when you quit. Nothing is written to disk.

Getting a session ID

Session IDs appear in the footer of the TUI. You can also find them in the session list (/session list). If you need to reference a session, you can copy its ID from the list — for example, to share a debugging session with a teammate or to resume on another machine.

Privacy

Sessions are stored locally on your machine at ~/.toporic/sessions/. No session data is sent to Toporic’s servers — everything stays on your computer.