normalize sessions

Analyze Claude Code, Codex, Gemini CLI, and Normalize agent session logs.

Usage

normalize sessions [OPTIONS] [SESSION_ID]
normalize sessions plans [NAME]

Subcommands

Subcommand	Description
plans	List and view agent plans from ~/.claude/plans/ etc.

Options

Option	Description
--format <FORMAT>	Log format: claude (default), codex, gemini, normalize
--grep <PATTERN>	Filter sessions by regex pattern (searches content)
--root <PATH>	Project root directory
--limit <N>	Maximum sessions to list (default: 20)
--analyze	Run full analysis instead of raw log dump
--jq <EXPR>	Apply jq expression to output
--json	Output as JSON
--serve	Start web UI server
--port <PORT>	Server port (default: 3939)

Formats

Format	Directory	File Pattern
claude	~/.claude/projects/<encoded-path>/	*.jsonl
codex	~/.codex/sessions/YYYY/MM/DD/	*.jsonl
gemini	~/.gemini/tmp/<hash>/	logs.json
normalize	.normalize/agent/logs/	*.jsonl

Examples

# List Claude Code sessions (default)
normalize sessions

# List Normalize agent sessions
normalize sessions --format normalize

# Filter sessions by content
normalize sessions --format normalize --grep "benchmark"

# Show specific session with analysis
normalize sessions abc123 --analyze

# Show session with jq filtering
normalize sessions abc123 --jq '.tool_stats'

# JSON output for scripting
normalize sessions --json

Session Analysis

When using --analyze, reports include:

• Tool usage patterns (calls, errors per tool)
• Token consumption (input, output, cache)
• Message type counts
• Turn counts
• File token attribution (which files consumed tokens)