Sessions

Sessions are the core of Metateam. Every AI coding session can be captured, stored, and searched.

For trust boundaries and what gets stored/uploaded, read Security and Privacy.

Search Sessions

$ metateam session search [QUERY] [OPTIONS]

Examples:

$ metateam session search "session hooks" -n 3
$ metateam session search --when 7d -n 5
$ metateam session search --when today --tags persona-rivet

--when supports: today, yesterday, 7d, 2w, 1m, 1y, exact dates, and ranges.

$ metateam session show <SESSION_ID>

Session ID accepts git-style prefixes (8+ hex chars).

Useful options:

$ metateam session show <SESSION_ID> --full
$ metateam session show <SESSION_ID> -s 2000

$ metateam session last

Optional output controls:

$ metateam session last --full
$ metateam session last -s 2000

$ metateam session info <SESSION_ID>

Use --title for title-only output and -j for JSON.

$ metateam session delete <SESSION_ID> [-y]

Pass -y to skip confirmation.

$ metateam session upload [SOURCE_OR_TARGET] [FILE]

Examples:

$ metateam session upload claude
$ metateam session upload all
$ metateam session upload 82bbfb7c
$ metateam session upload claude file.jsonl

SOURCE_OR_TARGET can be a provider (claude, codex, gemini, all), a session prefix (8+ hex), or a file path.

$ metateam session stats