Metadata-Version: 2.5
Name: aesop-agentic
Version: 0.4.0
Summary: Deterministic archive and backup service for AI interaction histories.
Project-URL: Homepage, https://colinconwell.github.io/Aesop-Agentic/
Project-URL: Documentation, https://colinconwell.github.io/Aesop-Agentic/
Project-URL: Repository, https://github.com/ColinConwell/Aesop-Agentic
Project-URL: Issues, https://github.com/ColinConwell/Aesop-Agentic/issues
Project-URL: Changelog, https://github.com/ColinConwell/Aesop-Agentic/releases
Author-email: Colin Conwell <conwell@mit.edu>
License-Expression: GPL-3.0-only
License-File: LICENSE
Keywords: agents,ai,archive,backup,conversations
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Archiving :: Backup
Requires-Python: >=3.11
Requires-Dist: textual<9,>=8.2
Provides-Extra: browser
Requires-Dist: playwright; extra == 'browser'
Description-Content-Type: text/markdown

<img align="right" width="150" src="https://colinconwell.github.io/Aesop-Agentic/assets/icon-light.png" alt="Aesop Agentic Archive mark">

# Aesop Agentic

A local archive for AI conversations, coding sessions, and agent histories.

[![PyPI](https://img.shields.io/pypi/v/aesop-agentic?color=6550d7)](https://pypi.org/project/aesop-agentic/)
[![Python](https://img.shields.io/pypi/pyversions/aesop-agentic)](https://pypi.org/project/aesop-agentic/)
[![Documentation](https://github.com/ColinConwell/Aesop-Agentic/actions/workflows/docs.yml/badge.svg)](https://colinconwell.github.io/Aesop-Agentic/)
[![Package](https://github.com/ColinConwell/Aesop-Agentic/actions/workflows/publish.yml/badge.svg)](https://github.com/ColinConwell/Aesop-Agentic/actions/workflows/publish.yml)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://github.com/ColinConwell/Aesop-Agentic/blob/main/LICENSE)

Aesop preserves histories from the tools you already use, keeps original records alongside readable transcripts, and mirrors the archive to your backup destinations. It reads source stores without modifying them and reports gaps in coverage explicitly.

[Documentation](https://colinconwell.github.io/Aesop-Agentic/) · [Getting Started](https://colinconwell.github.io/Aesop-Agentic/getting-started/installation/) · [Worked Examples](https://colinconwell.github.io/Aesop-Agentic/vignettes/coding-sessions/) · [Source Coverage](https://colinconwell.github.io/Aesop-Agentic/reference/sources/)

## Features

- **Collect local histories.** Preserve persisted sessions from Codex, Claude Code, Cursor, Gemini CLI, Pi, and other supported applications.
- **Import account exports.** Keep official ChatGPT and Claude exports, with optional isolated browser collection between exports.
- **Read your archive.** Browse and search transcripts in a local browser interface, inspect status in the terminal dashboard, or use the generated Markdown library.
- **Retain provenance.** Keep raw artifacts, checksums, source metadata, and content-addressed session revisions. Large mutable databases use verified latest snapshots.
- **Back up and verify.** Mirror to local storage, rclone, or Git LFS, then check integrity and test a restore.
- **Schedule on macOS.** Install a native Aesop Agentic launcher and background service with configurable notifications.

## Install

Requires Python 3.11 or newer. Aesop is macOS-first. Install in a virtual environment:

```sh
python3 -m venv ~/.venvs/aesop-agentic
source ~/.venvs/aesop-agentic/bin/activate
python -m pip install aesop-agentic
```

Choose a permanent archive workspace, then create your configuration:

```sh
mkdir -p ~/Aesop
cd ~/Aesop
aesop setup
aesop preferences --ui browser
aesop browser
```

Opening the interface does not start collection. Review your sources and backup destinations before the first run: setup uses `~/Aesop/data` in this example and configures an iCloud Drive mirror by default.

The PyPI package includes the command line, terminal dashboard, and browser interface. The optional Tauri desktop window requires a [source build](https://colinconwell.github.io/Aesop-Agentic/guides/interfaces/). See the [installation guide](https://colinconwell.github.io/Aesop-Agentic/getting-started/installation/) for browser capture, upgrades, and macOS service setup.

## Coverage and Privacy

Readable coverage depends on what each application persists. Unknown formats remain archived as opaque evidence; browser captures remain partial. Aesop cannot recover deleted or never-saved conversations, and successful discovery does not prove complete account coverage.

Archives may contain private conversations, code, and attachments. Browser authentication profiles stay outside the mirrored archive. Review the [privacy guide](https://colinconwell.github.io/Aesop-Agentic/guides/privacy/) and [coverage reference](https://colinconwell.github.io/Aesop-Agentic/reference/sources/) before choosing backup destinations.

## Development

See [Contributing](https://colinconwell.github.io/Aesop-Agentic/development/contributing/) for source installation, tests, and documentation previews, and [Release Process](https://colinconwell.github.io/Aesop-Agentic/development/releases/) for local workflow testing and publishing.

Aesop Agentic is developed by Colin Conwell and distributed under the [GNU General Public License v3](https://github.com/ColinConwell/Aesop-Agentic/blob/main/LICENSE).
