Metadata-Version: 2.4
Name: agent-archive
Version: 0.1.1
Summary: Archive and browse agentic coding sessions
Project-URL: Homepage, https://github.com/sidmitra/agent-archive
Project-URL: Repository, https://github.com/sidmitra/agent-archive
Project-URL: Issues, https://github.com/sidmitra/agent-archive/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: mkdocs>=1.6.0
Requires-Dist: mkdocs-material>=9.5.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.2.0; extra == "dev"

# Agent Archive

Archive and browse agentic coding sessions. Parses agent session logs and generates a searchable MkDocs static site.

## Requirements

- Python 3.10+

## Installation

Install as a standalone CLI with [uv](https://docs.astral.sh/uv/):

```bash
uv tool install agent-archive
```

Or with pip:

```bash
pip install agent-archive
```

For development (from a local clone):

```bash
pip install -e ".[dev]"
```

## Usage

```bash
agent-archive sync --output ./site
```

This parses agent logs and generates Markdown files and an MkDocs site in the specified output directory.

## Development

Run tests:

```bash
PYTHONPATH=src pytest tests/ -v
```

## Project Structure

```
src/agent_archive/
  __init__.py
  cli.py              # Typer CLI entry point
  models.py            # Pydantic models (Session, Message)
  parsers/
    base.py            # Abstract BaseParser for plugin-style log parsers
```

## Adding a Parser

Subclass `BaseParser` to support a new agent log format:

```python
from pathlib import Path
from agent_archive.parsers.base import BaseParser
from agent_archive.models import Session

class MyAgentParser(BaseParser):
    def parse(self, filepath: Path) -> list[Session]:
        # Parse your agent's log format and return Session objects
        ...
```
