Skip to content

Sessions

A session is a saved conversation with an agent. Sessions are stored as JSON files in ~/.muaz/sessions/ — one file per session — and an index.json tracks metadata for the most recent 20 sessions.

  • Pass --session <id> on startup to resume a specific session:

    Terminal window
    muaz chat --session 3f9c1a2e-...
  • Use /sessions inside the REPL to browse recent sessions and pick one to resume.

  • Use /session to print the current session’s metadata (id, model, message count).

To hold a conversation without persisting it to disk:

Terminal window
muaz chat --incognito

Or toggle it mid-session with /incognito. Incognito sessions are never written to ~/.muaz/sessions/.