Metadata-Version: 2.5
Name: hftracer
Version: 0.1.0
Summary: Synchronize agent traces to Hugging Face buckets.
Project-URL: Repository, https://github.com/twangodev/hftracer
Project-URL: Issues, https://github.com/twangodev/hftracer/issues
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.14
Requires-Dist: huggingface-hub>=1.9.0
Requires-Dist: typer>=0.24.0
Description-Content-Type: text/markdown

# hftracer

[![Python](https://img.shields.io/badge/python-3.14%2B-blue?logo=python&logoColor=white)](https://www.python.org/downloads/)
[![MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

Synchronize agent traces to Hugging Face buckets.

## Installation

```sh
uv tool install hftracer
```

## Usage

```sh
uvx --from huggingface-hub hf auth login
hftracer init
hftracer sync --dry-run
hftracer sync
```

## Supported agents

| Agent | Sources |
| --- | --- |
| Codex | `~/.codex/sessions`, `~/.codex/archived_sessions` |
| Claude Code | `~/.claude/projects` |

## Features

- Incremental uploads with progress bars
- Original files and directory structure preserved
- Separate device namespaces; no remote deletions
