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:

Backend	Use case	Config key
`local` (default)	Parquet files in `~/.sigil/rows/`	—
`iceberg`	Apache Iceberg via REST catalog	`[iceberg]`
`clickhouse`	ClickHouse Cloud/self-hosted	`[clickhouse]`

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sigil_ai-1.2.0.tar.gz (123.7 kB view details)

Uploaded Mar 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sigil_ai-1.2.0-py3-none-any.whl (26.6 kB view details)

Uploaded Mar 21, 2026 Python 3

File details

Details for the file sigil_ai-1.2.0.tar.gz.

File metadata

Download URL: sigil_ai-1.2.0.tar.gz
Upload date: Mar 21, 2026
Size: 123.7 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for sigil_ai-1.2.0.tar.gz
Algorithm	Hash digest
SHA256	`a2f77213f06b7eee2f083ad1a2609ec5ae96ba82661a0254b2b3fc8c261efc1a`
MD5	`ddca556418ff2e9f5a5fc4149a430519`
BLAKE2b-256	`3086b209bee9e957a80d4c3df3adbafb01c726192447efbdbf0890c3432b7eea`

See more details on using hashes here.

File details

Details for the file sigil_ai-1.2.0-py3-none-any.whl.

File metadata

Download URL: sigil_ai-1.2.0-py3-none-any.whl
Upload date: Mar 21, 2026
Size: 26.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for sigil_ai-1.2.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`0599aeee37afc284f42a71feaec85e6903ac24135de9d9eaf410369183250e21`
MD5	`a931d95dc4bb676b3a5d91f897ebc4e8`
BLAKE2b-256	`c1a058b06f394b0e521b6b2fb5b8690bdea59027ee41d6130e14b2f27c284684`