sigil

Collect, store, and analyze your AI usage data from Claude Code and OpenAI Codex CLI.

Install

pip install sigil-ai

Quick Start

# See all available commands
uvx --from sigil-ai sigil --help

# Interactive config setup
uvx --from sigil-ai sigil init

# Push session data (auto-detects ~/.claude/projects/ and ~/.codex/sessions/)
uvx --from sigil-ai sigil push

# Incremental push is the default — use --full to re-push everything
uvx --from sigil-ai sigil push --full

Storage Backends

Configure via sigil init or ~/.sigil/config.toml. Three backends are supported:

Environment variables (SIGIL_*) can override any config value. See .env.template for the full list.

Configuration

# ~/.sigil/config.toml
storage_backend = "clickhouse"

[iceberg]
catalog_name = "default"
catalog_uri = "http://localhost:8181"
warehouse = "s3://bucket/warehouse"

[clickhouse]
host = "localhost"
database = "sigil"
user = "default"
password = ""

Development

uv run pytest              # Run tests
uv run ruff check src/     # Lint
uv run sigil --help        # CLI help