ChatArch: AI Conversation Archiver

ChatArch is a utility designed to migrate local AI chat histories to AWS S3, freeing up local disk space while preserving conversations in a human-readable, summarized, and searchable format.

Features

  • Multi-Platform Support: Automatically discovers chats from Gemini CLI, Roo Code (Cline), and Aider.
  • Smart Cleanup: Identifies and deletes "commit-only" chats (short messages used solely for git commits) before archiving.
  • Markdown Conversion: Converts complex JSON chat schemas into clean, readable Markdown files within the archive.
  • AI-Powered Summarization: Uses Gemini 2.5 Flash to generate 1-2 sentence summaries for every archived conversation.
  • Safe Archival:
    • Retention Policy: Only archives chats older than 20 days.
    • Verification: Local files are only deleted after a successful S3 upload.
    • Rate Limit Handling: Includes configurable delays and exponential backoff for API calls.
  • Space Reporting: Reports the total disk space reclaimed at the end of each run.

Prerequisites

  • Python & uv: Managed via uv.
  • AWS CLI: Must be configured with credentials that have s3:PutObject permissions.
  • 1Password CLI (op): Used to securely retrieve the Gemini API key.
  • Google Gemini API Key: Stored in 1Password at op://Private/GEMINI_API_KEY/credential.

Usage

Commands are managed via the Makefile for convenience.

1. Dry Run (Recommended)

Verify which files will be deleted or archived without actually performing any actions:

make dry-run

2. Actual Archive

Perform the cleanup and migration:

make archive

3. Using Limits

To test the full process on a small sample (e.g., 5 files):

make archive ARGS="--limit 5"

4. Maintenance

Run linting and auto-fixes:

make lint

Configuration

Settings like S3 bucket names, local search paths, and API delays are managed in config.yaml.

Logging

All detailed operations and API responses are logged to chatarch/archiver.log. Progress is displayed in the terminal via a status bar.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for inTEGraTOR from gravatar.com inTEGraTOR

Credits

Author: Mark Stouffer

License

MIT

Requires

Python >=3.12

Report project as malware

Download files

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

Source Distribution

agent_chat_archiver-0.1.0.tar.gz (250.5 kB view details)

Uploaded Source

Built Distribution

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

agent_chat_archiver-0.1.0-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file agent_chat_archiver-0.1.0.tar.gz.

File metadata

  • Download URL: agent_chat_archiver-0.1.0.tar.gz
  • Upload date:
  • Size: 250.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_chat_archiver-0.1.0.tar.gz
Algorithm Hash digest
SHA256 dfd15f180f0c16ef5e144c43f8141ac3fa22b51643b55ce8e7a1ed5d631b3982
MD5 2591b4c8d0bd952530669cb6553054b5
BLAKE2b-256 fdf9df86fbe7a7da846c7443c27434417e8c6421590b4104c39355a40a9ad304

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_chat_archiver-0.1.0.tar.gz:

Publisher: publish.yml on InTEGr8or/chatarch

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agent_chat_archiver-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_chat_archiver-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8ea5896c332faaba5842067e07d664a603e62a3004ca997b16e2c89fbd9a62c1
MD5 21667ec4ffc3151da8ec1461abc61441
BLAKE2b-256 280cc4e64e68f8729b9de17cfce6dc51af98f9a0844197f9512d5b19d04ab823

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_chat_archiver-0.1.0-py3-none-any.whl:

Publisher: publish.yml on InTEGr8or/chatarch

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.1

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page