How darkonlikescoffee/ai-archive works
AI Conversation Archive syncs Claude conversations into a portable GitHub repository of Markdown conversations and assets, with a web reader for search and browsing. The extension workflow fetches the active Claude conversation branch and attachments, normalizes them, then commits changed Markdown, assets, and the navigation index in one GitHub sync. The web app connects to GitHub, searches the index, and opens conversations and image assets. The graph reflects sampled calls and README-documented storage behavior; some extension message-handler wiring is unsampled.
Main entry points: content.js Claude collector · background.js Sync coordinator · popup.js Sync popup · main.jsx Archive dashboard
Components 16
Browser extension sync
- Sync popup
extension/popup.js - Claude collector
extension/content.js - Extension settings
extension/popup.js - Extension storage
Archive generation
- Sync coordinator
extension/background.js - Active branch selection
extension/content.js - Attachment collection
extension/content.js - Markdown and asset writer
extension/background.js - Search index
README.md - Markdown archive
README.md
Web archive reader
- Archive dashboard
web/src/main.jsx - GitHub reader
web/src/github.js - Conversation and asset reader
web/src/main.jsx
External services
- Claude.ai
- GitHub repository
Other components
- Archive user
Connections 21
- Archive user → Sync popup: starts sync
extension/popup.js - Sync popup → Extension settings: saves settings
extension/popup.js - Extension settings → Extension storage: writes settings
extension/popup.js - Sync popup → Claude collector: requests sync
extension/popup.js - Claude collector → Claude.ai: fetches conversations
extension/content.js - Claude collector → Active branch selection: selects lineage
extension/content.js - Claude collector → Attachment collection: collects files
extension/content.js - Claude collector → Sync coordinator: hands off normalized data
- Sync coordinator → Markdown and asset writer: prepares sync files
extension/background.js - Sync coordinator → GitHub repository: uploads and commits
extension/background.js - Markdown and asset writer → Markdown archive: writes conversations
README.md - Markdown and asset writer → Search index: updates navigation cache
extension/background.js - Markdown archive → GitHub repository: stored in repository
README.md - Search index → GitHub repository: stored in repository
README.md - Sync coordinator → Sync popup: reports progress
extension/background.js - Archive user → Archive dashboard: opens archive
web/src/main.jsx - Archive dashboard → GitHub reader: loads and opens entries
web/src/main.jsx - GitHub reader → GitHub repository: reads repository contents
web/src/github.js - Archive dashboard → Conversation and asset reader: renders conversations
web/src/main.jsx - Conversation and asset reader → GitHub reader: loads conversation and assets
web/src/main.jsx - GitHub repository → Archive dashboard: provides archive data