stats

omnisess stats

Aggregate tool counts and file-I/O activity from the transcript SQLite index.

Usage

omnisess stats [--session <id>] [--window <duration>] [--tool <name>] [--full] [--json]

• --session and --window are mutually exclusive.
• Without --session, aggregates over a time window (default 7d).
• --tool filters to one source (currently only claude is supported).
• --full is required to surface argument/result payloads — and only works if the index was previously populated with omnisess index --all --full.
• --json emits machine-readable output suitable for jq.

Prerequisites

The transcript index is populated lazily on first use, but for bulk runs it is faster to seed it once:

omnisess index --all

The index lives at os.UserCacheDir() + /omnisess/index.sqlite by default; override via OMNISESS_INDEX_PATH.

Instructions

1. Check that the omnisess binary is available:

if ! command -v omnisess &>/dev/null; then
  echo "omnisess not found. Install it with:"
  echo "  go install github.com/psacc/omnisess@latest"
  exit 1
fi

2. Run the command, passing through all arguments:

omnisess stats "$@"

Examples

# Last 7 days, default window
omnisess stats

# Last 30 days
omnisess stats --window 30d

# Single session detail
omnisess stats --session claude:5c3f2742

# JSON for scripting
omnisess stats --window 7d --json | jq .

# Capture full arguments + result payloads (privacy-sensitive)
omnisess index --all --full
omnisess stats --session claude:5c3f2742 --full