Metadata-Version: 2.4
Name: siftd
Version: 0.1.1
Summary: Personal LLM usage analytics. Ingest conversation logs from CLI coding tools, query via FTS5 and semantic search.
License-Expression: MIT
License-File: LICENSE
Keywords: analytics,claude,conversation,llm,search
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.12
Requires-Dist: httpx
Requires-Dist: loguru
Requires-Dist: pyyaml
Requires-Dist: tomlkit
Requires-Dist: tqdm
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Requires-Dist: ty; extra == 'dev'
Provides-Extra: embed
Requires-Dist: fastembed; extra == 'embed'
Requires-Dist: huggingface-hub; extra == 'embed'
Requires-Dist: numpy; extra == 'embed'
Requires-Dist: onnxruntime; extra == 'embed'
Requires-Dist: tokenizers; extra == 'embed'
Description-Content-Type: text/markdown

# siftd

Ingest and query conversation logs from LLM coding tools. Stores in SQLite, searches via FTS5 and embeddings.

Warning: This project is under active development and breaking changes may occur.

## Install

```bash
pip install siftd              # core (query, tags, ingest)
pip install siftd[embed]       # with semantic search
```

## Usage

```bash
# Ingest logs from Claude Code, Gemini CLI, Codex, Aider
siftd ingest

# List recent conversations
siftd query -w .               # current workspace
siftd query --since 7d         # last week

# Semantic search (requires [embed])
siftd ask "how did I handle auth"
siftd ask -w myproject "error handling"

# Tag and filter
siftd tag 01JGK3 decision:auth
siftd query -l decision:
```

## Supported Tools

- Claude Code
- Gemini CLI
- Codex CLI
- Aider

## Commands

| Command | Description |
|---------|-------------|
| `ingest` | Import conversation logs |
| `query` | List/filter conversations |
| `ask` | Semantic search |
| `tag` | Apply tags to conversations |
| `peek` | View conversation contents |
| `doctor` | Check configuration |

## Documentation

- [CLI Reference](docs/cli.md)

## License

MIT
