v0.4.3 Β· New: interactive TUI Β· MIT Licensed

Archive. Search. Understand.

A local-first archive, search, and intelligence engine
for your LLM conversation history.

part β†’ whole β†’ part β†’ whole
$ pip install ricoeur

Everything you need to understand your AI history

Import, search, analyze, and explore your conversations across platforms β€” entirely on your machine.

Local-First

Your data stays on your machine. SQLite database, no cloud required. Full ownership of your conversation archive.

Multi-Platform

Import from ChatGPT and Claude today. Gemini and custom JSON imports coming soon.

Full-Text Search

FTS5-powered instant search across all messages. Filter by platform, language, model, date, or role.

Interactive TUI New

Browse, search, and read your entire archive without leaving the terminal. Markdown-rendered conversations, instant keyword search, keyboard-driven.

Topic Discovery Coming soon

BERTopic-powered topic modeling. Discover themes and patterns in your conversation history automatically.

Semantic Search

Embedding-powered similarity search using sentence-transformers or Ollama. Find conversations by meaning, not keywords.

MCP Integration Coming soon

Expose your archive as a Model Context Protocol server. Let your current AI access your past conversations.

Up and running in minutes

Import your data, search your history, discover patterns.

# Install ricoeur
pip install ricoeur

# Initialize database
ricoeur init
Initialized ricoeur at ~/.ricoeur

# Import your ChatGPT export
ricoeur import chatgpt ~/Downloads/export.zip
Import from ChatGPT
  Parsed:       3,756 conversations (42,618 messages)
  New:          3,756

# Check your archive stats
ricoeur stats
ricoeur β€” your conversation archive
Search your conversations… (Enter to search, empty = recent)▏
3,756 conversations Β· newest first
DatePlatformMsgsTitle
2026-05-30chatgpt24Deploying FastAPI on Fly.io
2026-05-29claude8Rust lifetimes, explained simply
2026-05-29chatgpt41Designing a hybrid search ranker
2026-05-28claude15SQLite FTS5 vs. vector embeddings
2026-05-27chatgpt6Refactoring a Textual DataTable
2026-05-26claude33BERTopic for conversation clustering
2026-05-25chatgpt12Async patterns in modern Python
2026-05-24claude19Local-first app architecture notes

Your CLI toolkit

A focused, composable interface for your conversation history.

ricoeur init
Initialize a new ricoeur database and config at ~/.ricoeur
ricoeur import
Import from ChatGPT exports (.json or .zip)
ricoeur search
Hybrid, semantic, or keyword search with filters for platform, language, model, and date
ricoeur show
Display a full conversation in rich, markdown, or JSON format
ricoeur stats
Analytics dashboard with counts by platform, model, and language
ricoeur topics Soon
Discover themes with BERTopic-powered topic modeling
ricoeur index
Build embeddings and summaries for semantic search
ricoeur mcp Soon
Start a Model Context Protocol server for AI-to-archive access
ricoeur tui
Launch the interactive terminal UI for browsing conversations
ricoeur serve Soon
Start a FastAPI web server with REST endpoints
To understand oneself is to understand oneself in front of the text.
Paul Ricoeur