Session Roaming

Transfer task context between AI agent CLIs seamlessly.

How it works

Start a task in Claude Code, save session context, switch to Codex or Gemini — the next agent auto-detects the session and picks up where you left off.

# Save session in Claude Code
0dai session save --goal "implement auth" --summary "designed API, need implementation"

# Switch to another agent — it sees:
# [ai-layer] ACTIVE SESSION DETECTED
#   Goal: implement auth
#   Roaming: claude -> codex
#   Handoff: designed API, need implementation

What transfers

Goal — what you're working on
Plan — steps and completion status
Files touched — what was modified
Key decisions — architecture choices made
Handoff notes — free-text context for the next agent

Commands

Command	Description
`session save --goal "..."`	Save or update active session
`session status`	Show active session
`session complete`	Archive to history
`session history`	Past sessions

Storage

Sessions live in ai/sessions/active.json. Completed sessions archive to ai/sessions/archive/. No server required — purely file-based.