{
  "markdown": "# RecallBase\n\n> Give any AI agent instant access to your conversation history—across agents and web AI, all stored locally.\n\n[![npm](https://img.shields.io/npm/v/recallbase)](https://www.npmjs.com/package/recallbase)\n[![Chrome Web Store](https://img.shields.io/badge/Chrome-Web%20Store-blue?logo=googlechrome&logoColor=white)](https://chromewebstore.google.com/detail/ai-chat-exporter-archive/fapgpimjelmfedlapidmfljcpmenmjeb)\n[![Microsoft Edge Add-ons](https://img.shields.io/badge/Edge-Add--ons-0078D7?logo=microsoftedge&logoColor=white)](https://microsoftedge.microsoft.com/addons/detail/ai-chat-exporter-archiv/gnlcemcmimkbgmnlclipknjjghllfdac)\n[![CI](https://img.shields.io/github/actions/workflow/status/DarinRowe/RecallBase/ci.yml?label=CI)](https://github.com/DarinRowe/RecallBase/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![macOS · Linux · Windows](https://img.shields.io/badge/platform-macOS%20·%20Linux%20·%20Windows-blue)](https://recallbase.net/docs/install-cli/)\n\n[Product](https://recallbase.net/desktop-cli/) · [Install the CLI](https://recallbase.net/docs/install-cli/) · [Developer resources](https://recallbase.net/developers/) · [Contributing](CONTRIBUTING.md)\n\n> **Your data stays local.** No account required. Raw transcripts never leave your machine. [Full privacy details →](#privacy)\n\n> **Early release:** RecallBase is usable today, but import coverage and packaging are still evolving. Keep backups of irreplaceable source histories.\n\n---\n\n## Install\n\n**[Read the complete CLI installation guide →](https://recallbase.net/docs/install-cli/)**\n\n### Requirements\n\n- Node.js 22 or newer, with npm, for the recommended npm installation\n- macOS, Linux, or Windows\n\nThe local CLI does not require a RecallBase account or cloud service.\n\n### Get Started in 60 Seconds\n\n```bash\nnpm install -g recallbase\n\nrb --help    # verify the installation\nrb import    # scan all known local sources\nrb today     # what did you work on today?\n```\n\nThat's it. No login, no config, no cloud. For alternative installation methods, `PATH` setup, and troubleshooting, use the [installation guide](https://recallbase.net/docs/install-cli/).\n\n---\n\n## The Problem\n\nYou use multiple AI tools every day — coding agents in the terminal, AI chat in the browser, different models for different tasks. But each one lives in its own silo:\n\n- A **tool update** silently wipes your local agent session history\n- An **account reset** and your ChatGPT conversations are gone\n- You switch machines and your history **doesn't follow**\n- You start a new session and spend the first 10 minutes **re-explaining everything**\n- You ask an agent to continue yesterday's work, and it **has no idea what yesterday was**\n\nThe history exists — scattered across local files, browser tabs, and cloud accounts. But it's unreachable when you need it.\n\n---\n\n## What RecallBase Does\n\nRecallBase pulls all of that history into a single local index, then makes it retrievable in under 200ms — for you, and for any agent you're working with.\n\n```\nrb import        # scan all known sources, incrementally\nrb today         # what did I work on today?\nrb search \"jwt retry logic\"   # find any conversation by topic\nrb open <id>     # read a specific session in full\nrb sources       # check which sources are healthy\nrb backup        # export everything to JSON\n```\n\nNo login required. Your data never leaves your machine.\n\n---\n\n## How It Compares\n\n|                                   | RecallBase | mem0 | Rewind | Manual export |\n| --------------------------------- | :--------: | :--: | :----: | :-----------: |\n| Works fully offline / local-first |     ✅     |  ❌  |   ✅   |      ✅       |\n| Covers CLI agents + browser AI    |     ✅     |  ❌  |   ❌   |      ❌       |\n| MCP server built-in               |     ✅     |  ❌  |   ❌   |      ❌       |\n| Sub-200ms local search            |     ✅     |  —   |   —    |       —       |\n| No subscription required          |     ✅     |  ❌  |   ❌   |      ✅       |\n| Import from official exports      |     ✅     |  ❌  |   ❌   |      ✅       |\n\n---\n\n## The Agent Experience\n\nThis is what RecallBase is actually for.\n\nYou open a new terminal, start a fresh agent, and ask:\n\n> **\"What did I work on today?\"**\n\nWithout RecallBase, the agent has no idea. You scroll through four different apps and piece it together yourself.\n\nWith RecallBase:\n\n```\nYou: What did I work on today?\n\nAgent: This morning you debugged the OAuth token refresh loop in the edge\n       service — you traced it to a race condition and left a TODO to add\n       exponential backoff. After lunch, you reviewed the importer contract for\n       Claude Code and added fixture tests for the cursor-based deduplication\n       logic. You ended the day opening a PR for the MCP sources tool. The\n       exponential backoff TODO is still open.\n```\n\nThe agent called `rb today --json` in the background. No manual context-setting. No copy-pasting chat logs. Just continuity.\n\nThe same works mid-task. When an agent needs to find a prior decision:\n\n```\nAgent calls: rb search \"exponential backoff\" --json\n→ Returns the exact conversation, with context, in milliseconds.\n```\n\n### MCP Integration\n\nAdd RecallBase as an MCP server to any agent that supports it — Cursor, Claude Desktop, GitHub Copilot, Zed, Windsurf, and more:\n\n```json\n{\n  \"mcpServers\": {\n    \"recallbase\": {\n      \"command\": \"rb\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\nThe agent gains four tools: `today`, `search`, `open`, and `sources`. The MCP server starts in milliseconds, has no external dependencies, and runs entirely locally — no API key, no rate limits.\n\n### Agent Skill\n\nThe portable Agent Skills package lives in [`skills/recallbase/`](skills/recallbase/). Install it globally with the [`skills` CLI](https://github.com/vercel-labs/skills) so RecallBase is available across projects:\n\n```bash\nnpx skills add DarinRowe/RecallBase --global\n```\n\nUpdate the global installation later with:\n\n```bash\nnpx skills update recallbase --global\n```\n\n---\n\n## Supported Sources\n\n### Agents\n\n| Source                          | Status       |\n| ------------------------------- | ------------ |\n| OpenAI Codex CLI + ChatGPT app | ✅ Core      |\n| Claude Code                     | ✅ Core      |\n| Cursor Desktop + Agent CLI      | ✅ Supported |\n| GitHub Copilot                  | ✅ Supported |\n| Grok Build                      | ✅ Supported |\n| Kimi Code                       | ✅ Supported |\n| OpenCode                        | ✅ Supported |\n\n### Web AI - Browser Extension\n\nThe browser extension captures conversations from web AI tools. It can quick-export the current conversation to Markdown or Obsidian, or open Export Studio to preview the full conversation, select messages, choose width/theme, and export Markdown, Obsidian, image, or text. RecallBase local import still uses the native messaging host. No cloud upload happens by default.\n\n| ChatGPT | Claude | Gemini | DeepSeek | Grok | Perplexity |\n| :-----: | :----: | :----: | :------: | :--: | :--------: |\n|    ✓    |   ✓    |   ✓    |    ✓     |  ✓   |     ✓      |\n\n| Kimi | Qwen | Doubao | Tencent Yuanbao | NotebookLM | Google AI Studio | GitHub Copilot | Microsoft Copilot |\n| :--: | :--: | :----: | :-------------: | :--------: | :--------------: | :------------: | :---------------: |\n|  ✓   |  ✓   |   ✓    |        ✓        |     ✓      |        ✓         |       ✓        |         ✓         |\n\n## Privacy\n\nRecallBase is **local-first by design**:\n\n- All data is stored on your machine in a SQLite database\n- No account required for any local feature\n- Raw transcripts never leave your machine\n\n---\n\n## Optional: Archive Web AI Chats\n\n[Install the browser extension →](https://recallbase.net/docs/install-browser-extension/)\n\nThe browser extension is a separate, optional product surface for saving conversations from supported web AI apps. Its installation and browser-specific setup live in the website documentation so they stay current without duplicating them here.\n\nTo make extension captures available to the local CLI and agents, install and verify the native messaging host once:\n\n```bash\n# Install the native messaging host (required once)\nrb extension install-host\nrb extension verify-host\n```\n\nThe native messaging host is only required for RecallBase import and agent access. For CLI installation and general troubleshooting, see the [CLI installation guide](https://recallbase.net/docs/install-cli/).\n\n---\n\n## Contributing\n\nContributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, guidelines, and how to submit changes. Please also read our [Code of Conduct](CODE_OF_CONDUCT.md).\n\nQuick start:\n\n```bash\nbun install --frozen-lockfile\nbun run typecheck\nbun run test\n```\n\nSee [docs/README.md](docs/README.md) for architecture notes, importer contracts, and fixture guidelines. If a compiled binary fails SQLite/FTS smoke checks, see [docs/release/platforms.md](docs/release/platforms.md).\n\n## License\n\nRecallBase is released under the [MIT License](LICENSE).\n",
  "bytes": 9048,
  "sha": "e02216d5e11ca9f3d5fce7e70673a55eb16246c5feac99292bb34fb4c2a374f3",
  "repo_slug": "darinrowe/recallbase",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_darinrowe_recallbase_c0824310/readme"
}