Skip to main content

​
Overview

The sessions command lets you browse, search, and export AI chat sessions. By default it launches an interactive TUI. With --agent, it returns structured JSON. 
oobo sessions              # Interactive TUI
oobo sessions --agent      # JSON output
oobo sessions --all        # All projects

​
Subcommands

​
sessions list

List sessions for the current project (or all projects with --all). 
oobo sessions list
oobo sessions list --all
oobo sessions list --agent
​
--all
boolean
default:"false"
Show sessions from all projects instead of just the current project.
​
--tool
string
Filter by tool (cursor, claude, gemini, windsurf, aider, copilot, zed, trae, codex, opencode).
​
-n, --limit
number
Maximum number of sessions to return.
​
--agent
boolean
default:"false"
Output as JSON for AI agents and scripts.
oobo sessions list

​
sessions show

Show a session’s full conversation. 
oobo sessions show <id>
oobo sessions show abc12def            # prefix match
oobo sessions show abc12def --agent    # JSON output
​
id
string
required
Session ID or prefix. Full UUIDs and short prefixes both work.
​
--agent
boolean
default:"false"
Output as JSON with full message array.
oobo sessions show abc12def
Search sessions by keyword. Matches session name, first message, and transcript content. 
oobo sessions search "auth bug"
oobo sessions search "auth bug" --all
oobo sessions search "auth bug" --agent
​
query
string
required
Search query. Matches session name, ID, source, mode, and first message.
​
--all
boolean
default:"false"
Search across all projects instead of just the current project.
​
-n, --limit
number
default:"20"
Maximum number of results to return.
​
--agent
boolean
default:"false"
Output as JSON.
oobo sessions search "auth bug"

​
sessions export

Export a session to a file in markdown or JSON format. 
oobo sessions export <id> --format md --out chat.md
oobo sessions export abc12def --format json --out session.json
oobo sessions export abc12def                  # prints to stdout
​
id
string
required
Session ID or prefix.
​
--format
string
default:"md"
Output format: md (markdown) or json.
​
--out
string
Output file path. If omitted, prints to stdout.
oobo sessions export abc12def --format md --out chat.md

​
Default Behavior

When you run oobo sessions with no subcommand, it defaults to sessions list with an interactive TUI: 
oobo sessions              # same as: oobo sessions list
oobo sessions --all        # same as: oobo sessions list --all
oobo sessions --agent      # same as: oobo sessions list --agent

​
Interactive TUI

The TUI shows:
  • Source - Tool that created the session (Cursor, Claude, Gemini, etc.)
  • Model - AI model used (claude-sonnet-4, gpt-4, etc.)
  • Tokens - Input + output token counts
  • Duration - Session length
  • Title - Session name or first message
Navigation:
  • Arrow keys - Move between sessions
  • Enter - View full conversation
  • Esc - Exit

​
Use Cases

​
Find recent sessions

oobo sessions

​
Search for a specific conversation

oobo sessions search "authentication"

​
Get session IDs for scripting

oobo sessions list --agent | jq -r '.[].session_id'

​
Export a session for sharing

oobo sessions export abc12def --format md --out review.md

​
View sessions from all projects

oobo sessions --all

​
Filter by tool

oobo sessions list --tool cursor --agent

​
Output Fields

All timestamp fields use ISO 8601 format (2026-03-08T10:30:00Z).

​
JSON Session Object

FieldTypeDescription
session_idstringFull session UUID
namestringSession title
sourcestringTool name (cursor, claude, gemini, etc.)
modestringSession mode (composer, chat, agent, etc.)
modelstringAI model used
input_tokensnumberInput tokens consumed
output_tokensnumberOutput tokens generated
duration_secsnumberSession duration in seconds
files_touchedarrayList of files modified
tool_callsnumberNumber of tool/function calls
project_pathstringAbsolute path to project
created_atstringISO 8601 timestamp
updated_atstringISO 8601 timestamp
is_estimatedbooleanTrue if tokens are estimated (tiktoken)

​
Next Steps

Share Sessions

Learn how to share redacted sessions

Stats

View token usage analytics across all sessions

Build docs developers (and LLMs) love

Get started for freeTalk to us