anamnesis-cli 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. anamnesis_cli-0.1.0/LICENSE +21 -0
  2. anamnesis_cli-0.1.0/PKG-INFO +287 -0
  3. anamnesis_cli-0.1.0/README.md +247 -0
  4. anamnesis_cli-0.1.0/pyproject.toml +84 -0
  5. anamnesis_cli-0.1.0/setup.cfg +4 -0
  6. anamnesis_cli-0.1.0/src/anamnesis/__init__.py +0 -0
  7. anamnesis_cli-0.1.0/src/anamnesis/cli/__init__.py +0 -0
  8. anamnesis_cli-0.1.0/src/anamnesis/cli/__main__.py +551 -0
  9. anamnesis_cli-0.1.0/src/anamnesis/cli/app.py +567 -0
  10. anamnesis_cli-0.1.0/src/anamnesis/cli/app.tcss +160 -0
  11. anamnesis_cli-0.1.0/src/anamnesis/cli/archive_view.py +211 -0
  12. anamnesis_cli-0.1.0/src/anamnesis/cli/commands.py +57 -0
  13. anamnesis_cli-0.1.0/src/anamnesis/cli/look.py +176 -0
  14. anamnesis_cli-0.1.0/src/anamnesis/cli/node_cmd.py +453 -0
  15. anamnesis_cli-0.1.0/src/anamnesis/cli/setup_cmd.py +173 -0
  16. anamnesis_cli-0.1.0/src/anamnesis/cli/widgets.py +225 -0
  17. anamnesis_cli-0.1.0/src/anamnesis/config.py +109 -0
  18. anamnesis_cli-0.1.0/src/anamnesis/connect.py +343 -0
  19. anamnesis_cli-0.1.0/src/anamnesis/core/__init__.py +0 -0
  20. anamnesis_cli-0.1.0/src/anamnesis/core/db.py +563 -0
  21. anamnesis_cli-0.1.0/src/anamnesis/core/devices.py +639 -0
  22. anamnesis_cli-0.1.0/src/anamnesis/core/formatting.py +51 -0
  23. anamnesis_cli-0.1.0/src/anamnesis/core/memory.py +290 -0
  24. anamnesis_cli-0.1.0/src/anamnesis/core/models.py +76 -0
  25. anamnesis_cli-0.1.0/src/anamnesis/core/vector.py +289 -0
  26. anamnesis_cli-0.1.0/src/anamnesis/ingest/__init__.py +1 -0
  27. anamnesis_cli-0.1.0/src/anamnesis/ingest/base.py +74 -0
  28. anamnesis_cli-0.1.0/src/anamnesis/ingest/claude_code.py +85 -0
  29. anamnesis_cli-0.1.0/src/anamnesis/ingest/clean.py +54 -0
  30. anamnesis_cli-0.1.0/src/anamnesis/ingest/codex.py +136 -0
  31. anamnesis_cli-0.1.0/src/anamnesis/ingest/cursor.py +166 -0
  32. anamnesis_cli-0.1.0/src/anamnesis/ingest/exports.py +269 -0
  33. anamnesis_cli-0.1.0/src/anamnesis/ingest/gemini_cli.py +156 -0
  34. anamnesis_cli-0.1.0/src/anamnesis/ingest/runner.py +194 -0
  35. anamnesis_cli-0.1.0/src/anamnesis/memory_mcp/__init__.py +1 -0
  36. anamnesis_cli-0.1.0/src/anamnesis/memory_mcp/__main__.py +3 -0
  37. anamnesis_cli-0.1.0/src/anamnesis/memory_mcp/server.py +208 -0
  38. anamnesis_cli-0.1.0/src/anamnesis/node/__init__.py +1 -0
  39. anamnesis_cli-0.1.0/src/anamnesis/node/app.py +476 -0
  40. anamnesis_cli-0.1.0/src/anamnesis/node/auth.py +405 -0
  41. anamnesis_cli-0.1.0/src/anamnesis/retention.py +75 -0
  42. anamnesis_cli-0.1.0/src/anamnesis/web/__init__.py +0 -0
  43. anamnesis_cli-0.1.0/src/anamnesis/web/__main__.py +21 -0
  44. anamnesis_cli-0.1.0/src/anamnesis/web/main.py +265 -0
  45. anamnesis_cli-0.1.0/src/anamnesis/web/static/app.js +380 -0
  46. anamnesis_cli-0.1.0/src/anamnesis/web/static/index.html +48 -0
  47. anamnesis_cli-0.1.0/src/anamnesis/web/static/markdown.js +79 -0
  48. anamnesis_cli-0.1.0/src/anamnesis/web/static/style.css +143 -0
  49. anamnesis_cli-0.1.0/src/anamnesis_cli.egg-info/PKG-INFO +287 -0
  50. anamnesis_cli-0.1.0/src/anamnesis_cli.egg-info/SOURCES.txt +66 -0
  51. anamnesis_cli-0.1.0/src/anamnesis_cli.egg-info/dependency_links.txt +1 -0
  52. anamnesis_cli-0.1.0/src/anamnesis_cli.egg-info/entry_points.txt +4 -0
  53. anamnesis_cli-0.1.0/src/anamnesis_cli.egg-info/requires.txt +23 -0
  54. anamnesis_cli-0.1.0/src/anamnesis_cli.egg-info/top_level.txt +1 -0
  55. anamnesis_cli-0.1.0/tests/test_archive.py +123 -0
  56. anamnesis_cli-0.1.0/tests/test_commands.py +31 -0
  57. anamnesis_cli-0.1.0/tests/test_config.py +58 -0
  58. anamnesis_cli-0.1.0/tests/test_db.py +94 -0
  59. anamnesis_cli-0.1.0/tests/test_devices.py +201 -0
  60. anamnesis_cli-0.1.0/tests/test_e2e_browser.py +172 -0
  61. anamnesis_cli-0.1.0/tests/test_ingest.py +552 -0
  62. anamnesis_cli-0.1.0/tests/test_memory.py +439 -0
  63. anamnesis_cli-0.1.0/tests/test_node.py +486 -0
  64. anamnesis_cli-0.1.0/tests/test_review_regressions.py +54 -0
  65. anamnesis_cli-0.1.0/tests/test_setup.py +136 -0
  66. anamnesis_cli-0.1.0/tests/test_tui.py +275 -0
  67. anamnesis_cli-0.1.0/tests/test_vector.py +45 -0
  68. anamnesis_cli-0.1.0/tests/test_web.py +174 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 devHaitham481
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,287 @@
1
+ Metadata-Version: 2.4
2
+ Name: anamnesis-cli
3
+ Version: 0.1.0
4
+ Summary: One local memory shared by all your AI tools (Claude Code, Codex, Gemini CLI, Cursor, ChatGPT, claude.ai, Gemini)
5
+ License-Expression: MIT
6
+ Project-URL: Homepage, https://devhaitham481.github.io/anamnesis/
7
+ Project-URL: Source, https://github.com/devHaitham481/anamnesis
8
+ Project-URL: Issues, https://github.com/devHaitham481/anamnesis/issues
9
+ Keywords: mcp,memory,claude,chatgpt,cursor,codex,gemini,ai-tools
10
+ Classifier: Environment :: Console
11
+ Classifier: Operating System :: MacOS
12
+ Classifier: Operating System :: POSIX :: Linux
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Topic :: Utilities
15
+ Requires-Python: >=3.11
16
+ Description-Content-Type: text/markdown
17
+ License-File: LICENSE
18
+ Requires-Dist: pydantic>=2.6
19
+ Requires-Dist: python-dotenv>=1.0
20
+ Requires-Dist: aiosqlite>=0.20
21
+ Requires-Dist: numpy>=1.26
22
+ Requires-Dist: onnxruntime>=1.17
23
+ Requires-Dist: tokenizers>=0.15
24
+ Requires-Dist: huggingface_hub>=0.20
25
+ Requires-Dist: textual>=0.80
26
+ Requires-Dist: fastapi>=0.110
27
+ Requires-Dist: uvicorn[standard]>=0.29
28
+ Requires-Dist: mcp<3,>=2.3
29
+ Requires-Dist: zstandard>=0.22
30
+ Requires-Dist: cryptography>=42
31
+ Provides-Extra: dev
32
+ Requires-Dist: pytest>=8.0; extra == "dev"
33
+ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
34
+ Requires-Dist: ruff>=0.6; extra == "dev"
35
+ Requires-Dist: mypy>=1.10; extra == "dev"
36
+ Requires-Dist: httpx>=0.27; extra == "dev"
37
+ Provides-Extra: e2e
38
+ Requires-Dist: playwright>=1.45; extra == "e2e"
39
+ Dynamic: license-file
40
+
41
+ <h1 align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/logo.svg" alt="Anamnesis" width="380"></h1>
42
+
43
+ <p align="center"><b>Never lose an AI conversation again.</b><br>Every conversation with every AI tool, kept on your computer and searchable by all of them.</p>
44
+
45
+ <p align="center">
46
+ <a href="https://github.com/devHaitham481/anamnesis/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/devHaitham481/anamnesis/actions/workflows/ci.yml/badge.svg"></a>
47
+ <a href="https://github.com/devHaitham481/anamnesis/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green"></a>
48
+ <img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-3776ab?logo=python&logoColor=white">
49
+ <img alt="MCP" src="https://img.shields.io/badge/MCP-server-c8653a">
50
+ <a href="https://devhaitham481.github.io/anamnesis/"><img alt="Website" src="https://img.shields.io/badge/website-anamnesis-1c1a17"></a>
51
+ </p>
52
+
53
+ <p align="center">
54
+ <img alt="Works with Claude Code" src="https://img.shields.io/badge/Claude_Code-d97757?logo=claude&logoColor=white">
55
+ <img alt="Works with Codex" src="https://img.shields.io/badge/Codex-000000?logo=openai&logoColor=white">
56
+ <img alt="Works with Cursor" src="https://img.shields.io/badge/Cursor-000000?logo=cursor&logoColor=white">
57
+ <img alt="Works with Gemini CLI" src="https://img.shields.io/badge/Gemini_CLI-8e75b2?logo=googlegemini&logoColor=white">
58
+ <img alt="Works with ChatGPT" src="https://img.shields.io/badge/ChatGPT-10a37f?logo=openai&logoColor=white">
59
+ <img alt="Works with claude.ai" src="https://img.shields.io/badge/claude.ai-d97757?logo=claude&logoColor=white">
60
+ </p>
61
+
62
+ <p align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/demo.gif" alt="Demo: anam status shows the archive across eight AI tools, anam searches it from the shell, and the terminal UI filters, opens and searches conversations with vim keys" width="860"></p>
63
+
64
+ <p align="center"><sub><code>anam status</code>, a search from the shell, and the terminal UI (sample data).</sub></p>
65
+
66
+ Your AI tools don't keep your history for long. Claude Code deletes sessions after 30 days, and web chats stay locked inside their apps. Anamnesis keeps a permanent, word-for-word archive of your conversations from **Claude Code, Codex, Gemini CLI, Cursor, ChatGPT, claude.ai and Gemini** on your computer, and gives it back to every AI tool over [MCP](https://modelcontextprotocol.io). Ask Claude Code "what did we decide about auth?" and it finds the answer, even if you worked it out in ChatGPT months ago.
67
+
68
+ - **Keeps:** every conversation, permanently, even after the tool itself has deleted it.
69
+ - **Collects:** reads the history your AI tools already keep, in the background.
70
+ - **Recalls:** keyword and semantic search, run locally, for every connected agent. A search takes about a tenth of a second.
71
+ - **Remembers:** agents save decisions with `remember`, visible to all your tools.
72
+ - **Stays yours:** everything in local SQLite, with a small local embedding model. No account, no API keys, no telemetry.
73
+
74
+ It is only the memory: it never calls a model, and you keep using the tools you already use.
75
+
76
+
77
+ ## Why "Anamnesis"?
78
+
79
+ *Anamnesis* (Greek ἀνάμνησις) means "recollection". In Plato it's the idea that learning is remembering what you already knew; in medicine it's a patient's history, taken so nobody starts from scratch. Both fit: your AI tools recall what you already worked out, with your whole history in front of them.
80
+
81
+ ## Install
82
+
83
+ On macOS or Linux:
84
+
85
+ ```bash
86
+ curl -LsSf https://devhaitham481.github.io/anamnesis/install.sh | sh
87
+ ```
88
+
89
+ The [script](https://devhaitham481.github.io/anamnesis/install.sh) installs [uv](https://docs.astral.sh/uv/) if needed, then Anamnesis in its own environment, with its own Python (nothing to preinstall; your system Python is never touched). Then it runs `anam setup`, which:
90
+
91
+ 1. finds the AI tools on your computer,
92
+ 2. archives their history (the first run downloads a 70 MB search model),
93
+ 3. offers to stop Claude Code deleting old sessions,
94
+ 4. asks, then connects them (each config is backed up first),
95
+ 5. shows what's archived and how to add your web chats.
96
+
97
+ **Then restart your AI tools.** That's it.
98
+
99
+ <details>
100
+ <summary>Install without the script</summary>
101
+
102
+ ```bash
103
+ uv tool install git+https://github.com/devHaitham481/anamnesis # or: pipx install git+https://…
104
+ anam setup
105
+ ```
106
+
107
+ Needs macOS or Linux (on Windows, use WSL) and Python 3.11+ (uv fetches it if needed).
108
+ </details>
109
+
110
+ <details>
111
+ <summary>Update, uninstall</summary>
112
+
113
+ **Update:** run the install command again. Setup re-runs safely and repairs tool connections left by an older version.
114
+
115
+ **Uninstall:**
116
+
117
+ ```bash
118
+ anam disconnect all # remove Anamnesis from your AI tools' configs
119
+ uv tool uninstall anamnesis-cli
120
+ rm -rf ~/.anamnesis # your memory; skip this to keep it
121
+ ```
122
+ </details>
123
+
124
+ <details>
125
+ <summary>Troubleshooting</summary>
126
+
127
+ - **`anam: command not found`:** open a new terminal. The installer added `~/.local/bin` to your PATH, which only applies to new terminals.
128
+ - **A tool doesn't seem to use the memory:** restart it. If `anam status` shows it as *outdated*, run `anam setup`.
129
+ - **The first import takes a while:** the semantic index is built once. Keyword search works right away.
130
+ - **No internet on first run:** semantic search stays off until the model can be downloaded; keyword search works.
131
+ </details>
132
+
133
+ ## Using it
134
+
135
+ Just keep working. While any connected tool is running, new conversations are archived in the background, and agents search the memory when earlier work comes up.
136
+
137
+ <p align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/status.svg" alt="anam status, then Claude Code answering a question from a decision made in ChatGPT" width="720"></p>
138
+
139
+ ```bash
140
+ anam # browse and search everything in the terminal
141
+ anam search "auth decision" # search from the shell (or just: anam auth decision)
142
+ anam import chatgpt.zip # add a ChatGPT, claude.ai or Gemini data export
143
+ anam status # your archive: what's kept per tool, what's missing
144
+ anam keep # stop Claude Code deleting its sessions after 30 days
145
+ ```
146
+
147
+ | Tool | How | Read from |
148
+ |---|---|---|
149
+ | Claude Code, Codex CLI, Gemini CLI, Cursor | automatic | their local session files (read-only) |
150
+ | ChatGPT | `anam import <export.zip>` | Settings → Data controls → Export data |
151
+ | claude.ai / Claude Desktop | `anam import <export.zip>` | Settings → Privacy → Export data |
152
+ | Gemini (web) | `anam import <takeout.zip>` | Google Takeout → My Activity → *Gemini Apps*, format **JSON** |
153
+
154
+ `anam status` shows the archive, what it has kept after a tool deleted it, how often your agents used it this week, and which web chats you haven't imported yet. Only what you and the assistant *said* is kept: tool calls and output, reasoning, and injected system context are skipped. Re-importing is safe.
155
+
156
+ ### Browse it yourself
157
+
158
+ `anam` opens the archive in the terminal: every conversation from every tool, and search across all of them. It's keyboard-first with vim keys: `j`/`k` to move, `l` to open, `h` to go back, `Ctrl+D`/`Ctrl+U` to scroll, and `/` to fuzzy-filter your conversations as you type (Enter searches every message).
159
+
160
+ <p align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/search.svg" alt="The Anamnesis terminal UI: conversations from every tool on the left, search results from ChatGPT, Claude Code and a saved note on the right" width="900"></p>
161
+
162
+ ## In claude.ai, ChatGPT and on your phone
163
+
164
+ Web and mobile apps can't reach your laptop, and your laptop isn't always on. So you run a **node**: your own always-on copy of the memory, on a server you control. There is no Anamnesis cloud. It also keeps all your computers in sync.
165
+
166
+ **1. Deploy it once.** On Fly.io:
167
+
168
+ ```bash
169
+ anam node deploy fly # creates the app, a 1 GB volume and your password, then links this computer
170
+ ```
171
+
172
+ Or on any server with Docker (VPS, NAS, home server). Point a domain at it first:
173
+
174
+ ```bash
175
+ curl -O https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docker-compose.yml
176
+ printf 'ANAMNESIS_DOMAIN=memory.example.com\nANAMNESIS_NODE_PASSWORD=%s\n' "$(openssl rand -base64 18)" > .env
177
+ docker compose up -d # HTTPS via Caddy; the password is in .env
178
+ ```
179
+
180
+ **2. Link each computer:** `anam node link https://your-node`. You choose what it uploads: everything, everything except some projects, or only saved notes (`anam node scope` changes it).
181
+
182
+ **3. Add the connector:** `anam connect claude-web` (or `chatgpt-web`) prints the steps. You paste `https://your-node/mcp` into the app and sign in with the node password, choosing search-only or search and save. Custom connectors need a paid claude.ai or ChatGPT plan; Gemini doesn't support them.
183
+
184
+ `anam node status` shows computers and connected apps, `anam node activity` every search and save an app made, `anam node revoke claude` cuts one off, and `anam node wipe` starts over.
185
+
186
+ <details>
187
+ <summary>Security, cost, updates</summary>
188
+
189
+ - **Security:** HTTPS, plus end-to-end encryption (AES-256-GCM) of synced data with a key only your computers and your node hold. The node must read your memory to search it, which is why it runs on your server. Apps get revocable OAuth tokens, never the password. Wrong passwords are rate-limited.
190
+ - **Cost:** one small machine. Fly.io's default here is 1 shared CPU, 1 GB of memory and a 1 GB volume; it stops when idle and wakes on the next request. A server you already have costs nothing extra.
191
+ - **Updates:** both paths use the prebuilt image `ghcr.io/devhaitham481/anamnesis` (x86 and ARM). Run `docker compose pull && docker compose up -d`, or re-run `anam node deploy fly --app <name>`.
192
+ </details>
193
+
194
+ <details>
195
+ <summary>Only need your computers in sync? Use a folder instead</summary>
196
+
197
+ ```bash
198
+ anam share # on your first computer: prints a pairing code
199
+ anam join XXXX-XXXX-… # on each other computer
200
+ ```
201
+
202
+ The default folder is `iCloud Drive/Anamnesis`; pass a path for Dropbox, Syncthing or anything else. Everything in it is end-to-end encrypted and the key lives only in the pairing code. `anam devices` lists computers; `anam unshare` stops syncing this one.
203
+ </details>
204
+
205
+ ## Reference
206
+
207
+ <details>
208
+ <summary>All commands</summary>
209
+
210
+ ```
211
+ anam setup guided setup; safe to re-run (after upgrades too)
212
+ anam terminal memory browser
213
+ anam sync [--watch] import new local history now (or keep watching)
214
+ anam import FILE... import ChatGPT / claude.ai / Gemini Takeout exports
215
+ anam search QUERY search everything from the shell [--source chatgpt] (or just: anam QUERY)
216
+ anam connect [TOOL|all] claude-code, claude-desktop, cursor, gemini-cli, codex
217
+ anam disconnect TOOL|all
218
+ anam status your archive per tool, what's missing, sync state, connected tools
219
+ anam keep stop Claude Code deleting its sessions after 30 days
220
+ anam share | join | devices | unshare sync computers through a folder
221
+ anam node deploy fly create your node on Fly.io (or use docker-compose.yml)
222
+ anam node link URL sync this computer through your node
223
+ anam node status|activity|revoke|scope|wipe
224
+ anam connect claude-web use your memory in claude.ai (also chatgpt-web)
225
+ anam mcp the MCP server (connected tools start it for you)
226
+ ```
227
+
228
+ `connect` merges into each tool's existing config and writes a `.bak` copy first. For Claude Code it runs `claude mcp add --scope user anamnesis …`. MCP tools: `search_memory`, `recent_conversations`, `get_conversation`, `remember`.
229
+ </details>
230
+
231
+ <details>
232
+ <summary>Terminal UI</summary>
233
+
234
+ Each conversation shows a dot in its tool's color; search results carry the tool's name as a label. Press `/` (or `Ctrl+F`) for the search box at the top: typing filters the list, Enter searches every message.
235
+
236
+ | Key / command | Action |
237
+ |---|---|
238
+ | *text* or `/search <query>`, `/open N` | Search all memory, open a result |
239
+ | `/history [source]` | Recent conversations, e.g. `/history chatgpt` |
240
+ | `/sync` | Import new history now |
241
+ | `j` `k` · `g` `G` · `Ctrl+D` `Ctrl+U` | Move or scroll (list and conversation) |
242
+ | `l` / `h` | Open the highlighted conversation / back to the list |
243
+ | `/` | Search box: typing fuzzy-filters the list, Enter searches every message |
244
+ | `Esc` | Clear the search box, then back to the list |
245
+ | `Ctrl+L` / `Ctrl+F` | Focus the conversation list / the search box |
246
+ | `/rename`, `/delete` (twice), `/help`, `Ctrl+Q` | Manage, help, quit |
247
+ </details>
248
+
249
+ <details>
250
+ <summary>Web UI and API</summary>
251
+
252
+ `anam-web`, then open http://127.0.0.1:8000.
253
+
254
+ | Endpoint | |
255
+ |---|---|
256
+ | `GET /api/sources` | Tools with conversation counts |
257
+ | `GET /api/threads?source=`, `GET /api/threads/{id}/messages` | Browse |
258
+ | `GET /api/search?q=&source=` | Semantic + keyword search |
259
+ | `PATCH`/`DELETE /api/threads/{id}` | Rename / delete a conversation |
260
+ | `WS /ws` | Live updates as new history is imported |
261
+
262
+ To reach it from other devices, set `ANAMNESIS_HOST=0.0.0.0`, `ANAMNESIS_ALLOWED_HOSTS` and `ANAMNESIS_AUTH_TOKEN`, then open `http://<host>:8000/?token=<token>` once.
263
+ </details>
264
+
265
+ <details>
266
+ <summary>Configuration</summary>
267
+
268
+ Nothing is required. Settings come from the environment or a `.env` file (see [`.env.example`](https://github.com/devHaitham481/anamnesis/blob/main/.env.example)). Data lives in `~/.anamnesis` (`ANAMNESIS_DATA_DIR`), with logs in `anamnesis.log` and `mcp.log` there.
269
+ </details>
270
+
271
+ ## Development
272
+
273
+ ```bash
274
+ git clone https://github.com/devHaitham481/anamnesis && cd anamnesis
275
+ uv venv -p 3.13 .venv && uv pip install -p .venv -e ".[dev]"
276
+ .venv/bin/pytest -q # all offline: importers, MCP, TUI, web, node, browser e2e
277
+ .venv/bin/ruff check . && .venv/bin/mypy src
278
+ ```
279
+
280
+ Use your checkout as your everyday `anam` with `uv tool install -e .` then `anam setup`.
281
+
282
+ Code lives in `src/anamnesis/`: `ingest/` (one parser per tool), `memory_mcp/` (MCP server), `core/` (storage, search, sync), `node/` (self-hosted node), `cli/` and `web/` (interfaces), `connect.py` (tool registration). The website and `install.sh` are in `site/`.
283
+
284
+
285
+ ## License
286
+
287
+ [MIT](https://github.com/devHaitham481/anamnesis/blob/main/LICENSE)
@@ -0,0 +1,247 @@
1
+ <h1 align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/logo.svg" alt="Anamnesis" width="380"></h1>
2
+
3
+ <p align="center"><b>Never lose an AI conversation again.</b><br>Every conversation with every AI tool, kept on your computer and searchable by all of them.</p>
4
+
5
+ <p align="center">
6
+ <a href="https://github.com/devHaitham481/anamnesis/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/devHaitham481/anamnesis/actions/workflows/ci.yml/badge.svg"></a>
7
+ <a href="https://github.com/devHaitham481/anamnesis/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green"></a>
8
+ <img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-3776ab?logo=python&logoColor=white">
9
+ <img alt="MCP" src="https://img.shields.io/badge/MCP-server-c8653a">
10
+ <a href="https://devhaitham481.github.io/anamnesis/"><img alt="Website" src="https://img.shields.io/badge/website-anamnesis-1c1a17"></a>
11
+ </p>
12
+
13
+ <p align="center">
14
+ <img alt="Works with Claude Code" src="https://img.shields.io/badge/Claude_Code-d97757?logo=claude&logoColor=white">
15
+ <img alt="Works with Codex" src="https://img.shields.io/badge/Codex-000000?logo=openai&logoColor=white">
16
+ <img alt="Works with Cursor" src="https://img.shields.io/badge/Cursor-000000?logo=cursor&logoColor=white">
17
+ <img alt="Works with Gemini CLI" src="https://img.shields.io/badge/Gemini_CLI-8e75b2?logo=googlegemini&logoColor=white">
18
+ <img alt="Works with ChatGPT" src="https://img.shields.io/badge/ChatGPT-10a37f?logo=openai&logoColor=white">
19
+ <img alt="Works with claude.ai" src="https://img.shields.io/badge/claude.ai-d97757?logo=claude&logoColor=white">
20
+ </p>
21
+
22
+ <p align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/demo.gif" alt="Demo: anam status shows the archive across eight AI tools, anam searches it from the shell, and the terminal UI filters, opens and searches conversations with vim keys" width="860"></p>
23
+
24
+ <p align="center"><sub><code>anam status</code>, a search from the shell, and the terminal UI (sample data).</sub></p>
25
+
26
+ Your AI tools don't keep your history for long. Claude Code deletes sessions after 30 days, and web chats stay locked inside their apps. Anamnesis keeps a permanent, word-for-word archive of your conversations from **Claude Code, Codex, Gemini CLI, Cursor, ChatGPT, claude.ai and Gemini** on your computer, and gives it back to every AI tool over [MCP](https://modelcontextprotocol.io). Ask Claude Code "what did we decide about auth?" and it finds the answer, even if you worked it out in ChatGPT months ago.
27
+
28
+ - **Keeps:** every conversation, permanently, even after the tool itself has deleted it.
29
+ - **Collects:** reads the history your AI tools already keep, in the background.
30
+ - **Recalls:** keyword and semantic search, run locally, for every connected agent. A search takes about a tenth of a second.
31
+ - **Remembers:** agents save decisions with `remember`, visible to all your tools.
32
+ - **Stays yours:** everything in local SQLite, with a small local embedding model. No account, no API keys, no telemetry.
33
+
34
+ It is only the memory: it never calls a model, and you keep using the tools you already use.
35
+
36
+
37
+ ## Why "Anamnesis"?
38
+
39
+ *Anamnesis* (Greek ἀνάμνησις) means "recollection". In Plato it's the idea that learning is remembering what you already knew; in medicine it's a patient's history, taken so nobody starts from scratch. Both fit: your AI tools recall what you already worked out, with your whole history in front of them.
40
+
41
+ ## Install
42
+
43
+ On macOS or Linux:
44
+
45
+ ```bash
46
+ curl -LsSf https://devhaitham481.github.io/anamnesis/install.sh | sh
47
+ ```
48
+
49
+ The [script](https://devhaitham481.github.io/anamnesis/install.sh) installs [uv](https://docs.astral.sh/uv/) if needed, then Anamnesis in its own environment, with its own Python (nothing to preinstall; your system Python is never touched). Then it runs `anam setup`, which:
50
+
51
+ 1. finds the AI tools on your computer,
52
+ 2. archives their history (the first run downloads a 70 MB search model),
53
+ 3. offers to stop Claude Code deleting old sessions,
54
+ 4. asks, then connects them (each config is backed up first),
55
+ 5. shows what's archived and how to add your web chats.
56
+
57
+ **Then restart your AI tools.** That's it.
58
+
59
+ <details>
60
+ <summary>Install without the script</summary>
61
+
62
+ ```bash
63
+ uv tool install git+https://github.com/devHaitham481/anamnesis # or: pipx install git+https://…
64
+ anam setup
65
+ ```
66
+
67
+ Needs macOS or Linux (on Windows, use WSL) and Python 3.11+ (uv fetches it if needed).
68
+ </details>
69
+
70
+ <details>
71
+ <summary>Update, uninstall</summary>
72
+
73
+ **Update:** run the install command again. Setup re-runs safely and repairs tool connections left by an older version.
74
+
75
+ **Uninstall:**
76
+
77
+ ```bash
78
+ anam disconnect all # remove Anamnesis from your AI tools' configs
79
+ uv tool uninstall anamnesis-cli
80
+ rm -rf ~/.anamnesis # your memory; skip this to keep it
81
+ ```
82
+ </details>
83
+
84
+ <details>
85
+ <summary>Troubleshooting</summary>
86
+
87
+ - **`anam: command not found`:** open a new terminal. The installer added `~/.local/bin` to your PATH, which only applies to new terminals.
88
+ - **A tool doesn't seem to use the memory:** restart it. If `anam status` shows it as *outdated*, run `anam setup`.
89
+ - **The first import takes a while:** the semantic index is built once. Keyword search works right away.
90
+ - **No internet on first run:** semantic search stays off until the model can be downloaded; keyword search works.
91
+ </details>
92
+
93
+ ## Using it
94
+
95
+ Just keep working. While any connected tool is running, new conversations are archived in the background, and agents search the memory when earlier work comes up.
96
+
97
+ <p align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/status.svg" alt="anam status, then Claude Code answering a question from a decision made in ChatGPT" width="720"></p>
98
+
99
+ ```bash
100
+ anam # browse and search everything in the terminal
101
+ anam search "auth decision" # search from the shell (or just: anam auth decision)
102
+ anam import chatgpt.zip # add a ChatGPT, claude.ai or Gemini data export
103
+ anam status # your archive: what's kept per tool, what's missing
104
+ anam keep # stop Claude Code deleting its sessions after 30 days
105
+ ```
106
+
107
+ | Tool | How | Read from |
108
+ |---|---|---|
109
+ | Claude Code, Codex CLI, Gemini CLI, Cursor | automatic | their local session files (read-only) |
110
+ | ChatGPT | `anam import <export.zip>` | Settings → Data controls → Export data |
111
+ | claude.ai / Claude Desktop | `anam import <export.zip>` | Settings → Privacy → Export data |
112
+ | Gemini (web) | `anam import <takeout.zip>` | Google Takeout → My Activity → *Gemini Apps*, format **JSON** |
113
+
114
+ `anam status` shows the archive, what it has kept after a tool deleted it, how often your agents used it this week, and which web chats you haven't imported yet. Only what you and the assistant *said* is kept: tool calls and output, reasoning, and injected system context are skipped. Re-importing is safe.
115
+
116
+ ### Browse it yourself
117
+
118
+ `anam` opens the archive in the terminal: every conversation from every tool, and search across all of them. It's keyboard-first with vim keys: `j`/`k` to move, `l` to open, `h` to go back, `Ctrl+D`/`Ctrl+U` to scroll, and `/` to fuzzy-filter your conversations as you type (Enter searches every message).
119
+
120
+ <p align="center"><img src="https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docs/search.svg" alt="The Anamnesis terminal UI: conversations from every tool on the left, search results from ChatGPT, Claude Code and a saved note on the right" width="900"></p>
121
+
122
+ ## In claude.ai, ChatGPT and on your phone
123
+
124
+ Web and mobile apps can't reach your laptop, and your laptop isn't always on. So you run a **node**: your own always-on copy of the memory, on a server you control. There is no Anamnesis cloud. It also keeps all your computers in sync.
125
+
126
+ **1. Deploy it once.** On Fly.io:
127
+
128
+ ```bash
129
+ anam node deploy fly # creates the app, a 1 GB volume and your password, then links this computer
130
+ ```
131
+
132
+ Or on any server with Docker (VPS, NAS, home server). Point a domain at it first:
133
+
134
+ ```bash
135
+ curl -O https://raw.githubusercontent.com/devHaitham481/anamnesis/main/docker-compose.yml
136
+ printf 'ANAMNESIS_DOMAIN=memory.example.com\nANAMNESIS_NODE_PASSWORD=%s\n' "$(openssl rand -base64 18)" > .env
137
+ docker compose up -d # HTTPS via Caddy; the password is in .env
138
+ ```
139
+
140
+ **2. Link each computer:** `anam node link https://your-node`. You choose what it uploads: everything, everything except some projects, or only saved notes (`anam node scope` changes it).
141
+
142
+ **3. Add the connector:** `anam connect claude-web` (or `chatgpt-web`) prints the steps. You paste `https://your-node/mcp` into the app and sign in with the node password, choosing search-only or search and save. Custom connectors need a paid claude.ai or ChatGPT plan; Gemini doesn't support them.
143
+
144
+ `anam node status` shows computers and connected apps, `anam node activity` every search and save an app made, `anam node revoke claude` cuts one off, and `anam node wipe` starts over.
145
+
146
+ <details>
147
+ <summary>Security, cost, updates</summary>
148
+
149
+ - **Security:** HTTPS, plus end-to-end encryption (AES-256-GCM) of synced data with a key only your computers and your node hold. The node must read your memory to search it, which is why it runs on your server. Apps get revocable OAuth tokens, never the password. Wrong passwords are rate-limited.
150
+ - **Cost:** one small machine. Fly.io's default here is 1 shared CPU, 1 GB of memory and a 1 GB volume; it stops when idle and wakes on the next request. A server you already have costs nothing extra.
151
+ - **Updates:** both paths use the prebuilt image `ghcr.io/devhaitham481/anamnesis` (x86 and ARM). Run `docker compose pull && docker compose up -d`, or re-run `anam node deploy fly --app <name>`.
152
+ </details>
153
+
154
+ <details>
155
+ <summary>Only need your computers in sync? Use a folder instead</summary>
156
+
157
+ ```bash
158
+ anam share # on your first computer: prints a pairing code
159
+ anam join XXXX-XXXX-… # on each other computer
160
+ ```
161
+
162
+ The default folder is `iCloud Drive/Anamnesis`; pass a path for Dropbox, Syncthing or anything else. Everything in it is end-to-end encrypted and the key lives only in the pairing code. `anam devices` lists computers; `anam unshare` stops syncing this one.
163
+ </details>
164
+
165
+ ## Reference
166
+
167
+ <details>
168
+ <summary>All commands</summary>
169
+
170
+ ```
171
+ anam setup guided setup; safe to re-run (after upgrades too)
172
+ anam terminal memory browser
173
+ anam sync [--watch] import new local history now (or keep watching)
174
+ anam import FILE... import ChatGPT / claude.ai / Gemini Takeout exports
175
+ anam search QUERY search everything from the shell [--source chatgpt] (or just: anam QUERY)
176
+ anam connect [TOOL|all] claude-code, claude-desktop, cursor, gemini-cli, codex
177
+ anam disconnect TOOL|all
178
+ anam status your archive per tool, what's missing, sync state, connected tools
179
+ anam keep stop Claude Code deleting its sessions after 30 days
180
+ anam share | join | devices | unshare sync computers through a folder
181
+ anam node deploy fly create your node on Fly.io (or use docker-compose.yml)
182
+ anam node link URL sync this computer through your node
183
+ anam node status|activity|revoke|scope|wipe
184
+ anam connect claude-web use your memory in claude.ai (also chatgpt-web)
185
+ anam mcp the MCP server (connected tools start it for you)
186
+ ```
187
+
188
+ `connect` merges into each tool's existing config and writes a `.bak` copy first. For Claude Code it runs `claude mcp add --scope user anamnesis …`. MCP tools: `search_memory`, `recent_conversations`, `get_conversation`, `remember`.
189
+ </details>
190
+
191
+ <details>
192
+ <summary>Terminal UI</summary>
193
+
194
+ Each conversation shows a dot in its tool's color; search results carry the tool's name as a label. Press `/` (or `Ctrl+F`) for the search box at the top: typing filters the list, Enter searches every message.
195
+
196
+ | Key / command | Action |
197
+ |---|---|
198
+ | *text* or `/search <query>`, `/open N` | Search all memory, open a result |
199
+ | `/history [source]` | Recent conversations, e.g. `/history chatgpt` |
200
+ | `/sync` | Import new history now |
201
+ | `j` `k` · `g` `G` · `Ctrl+D` `Ctrl+U` | Move or scroll (list and conversation) |
202
+ | `l` / `h` | Open the highlighted conversation / back to the list |
203
+ | `/` | Search box: typing fuzzy-filters the list, Enter searches every message |
204
+ | `Esc` | Clear the search box, then back to the list |
205
+ | `Ctrl+L` / `Ctrl+F` | Focus the conversation list / the search box |
206
+ | `/rename`, `/delete` (twice), `/help`, `Ctrl+Q` | Manage, help, quit |
207
+ </details>
208
+
209
+ <details>
210
+ <summary>Web UI and API</summary>
211
+
212
+ `anam-web`, then open http://127.0.0.1:8000.
213
+
214
+ | Endpoint | |
215
+ |---|---|
216
+ | `GET /api/sources` | Tools with conversation counts |
217
+ | `GET /api/threads?source=`, `GET /api/threads/{id}/messages` | Browse |
218
+ | `GET /api/search?q=&source=` | Semantic + keyword search |
219
+ | `PATCH`/`DELETE /api/threads/{id}` | Rename / delete a conversation |
220
+ | `WS /ws` | Live updates as new history is imported |
221
+
222
+ To reach it from other devices, set `ANAMNESIS_HOST=0.0.0.0`, `ANAMNESIS_ALLOWED_HOSTS` and `ANAMNESIS_AUTH_TOKEN`, then open `http://<host>:8000/?token=<token>` once.
223
+ </details>
224
+
225
+ <details>
226
+ <summary>Configuration</summary>
227
+
228
+ Nothing is required. Settings come from the environment or a `.env` file (see [`.env.example`](https://github.com/devHaitham481/anamnesis/blob/main/.env.example)). Data lives in `~/.anamnesis` (`ANAMNESIS_DATA_DIR`), with logs in `anamnesis.log` and `mcp.log` there.
229
+ </details>
230
+
231
+ ## Development
232
+
233
+ ```bash
234
+ git clone https://github.com/devHaitham481/anamnesis && cd anamnesis
235
+ uv venv -p 3.13 .venv && uv pip install -p .venv -e ".[dev]"
236
+ .venv/bin/pytest -q # all offline: importers, MCP, TUI, web, node, browser e2e
237
+ .venv/bin/ruff check . && .venv/bin/mypy src
238
+ ```
239
+
240
+ Use your checkout as your everyday `anam` with `uv tool install -e .` then `anam setup`.
241
+
242
+ Code lives in `src/anamnesis/`: `ingest/` (one parser per tool), `memory_mcp/` (MCP server), `core/` (storage, search, sync), `node/` (self-hosted node), `cli/` and `web/` (interfaces), `connect.py` (tool registration). The website and `install.sh` are in `site/`.
243
+
244
+
245
+ ## License
246
+
247
+ [MIT](https://github.com/devHaitham481/anamnesis/blob/main/LICENSE)
@@ -0,0 +1,84 @@
1
+ [build-system]
2
+ requires = ["setuptools>=77"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "anamnesis-cli"
7
+ version = "0.1.0"
8
+ description = "One local memory shared by all your AI tools (Claude Code, Codex, Gemini CLI, Cursor, ChatGPT, claude.ai, Gemini)"
9
+ readme = "README.md"
10
+ license = "MIT"
11
+ requires-python = ">=3.11"
12
+ keywords = ["mcp", "memory", "claude", "chatgpt", "cursor", "codex", "gemini", "ai-tools"]
13
+ classifiers = [
14
+ "Environment :: Console",
15
+ "Operating System :: MacOS",
16
+ "Operating System :: POSIX :: Linux",
17
+ "Programming Language :: Python :: 3",
18
+ "Topic :: Utilities",
19
+ ]
20
+ dependencies = [
21
+ "pydantic>=2.6",
22
+ "python-dotenv>=1.0",
23
+ "aiosqlite>=0.20",
24
+ "numpy>=1.26",
25
+ "onnxruntime>=1.17",
26
+ "tokenizers>=0.15",
27
+ "huggingface_hub>=0.20",
28
+ "textual>=0.80",
29
+ "fastapi>=0.110",
30
+ "uvicorn[standard]>=0.29",
31
+ "mcp>=2.3,<3",
32
+ "zstandard>=0.22",
33
+ "cryptography>=42",
34
+ ]
35
+
36
+ [project.urls]
37
+ Homepage = "https://devhaitham481.github.io/anamnesis/"
38
+ Source = "https://github.com/devHaitham481/anamnesis"
39
+ Issues = "https://github.com/devHaitham481/anamnesis/issues"
40
+
41
+ [project.scripts]
42
+ anam = "anamnesis.cli.__main__:main"
43
+ anam-web = "anamnesis.web.__main__:main"
44
+ anam-mcp = "anamnesis.memory_mcp.server:main"
45
+
46
+ [project.optional-dependencies]
47
+ dev = [
48
+ "pytest>=8.0",
49
+ "pytest-asyncio>=0.23",
50
+ "ruff>=0.6",
51
+ "mypy>=1.10",
52
+ "httpx>=0.27",
53
+ ]
54
+ e2e = ["playwright>=1.45"]
55
+
56
+ [tool.setuptools.packages.find]
57
+ where = ["src"]
58
+ include = ["anamnesis*"]
59
+
60
+ [tool.setuptools.package-data]
61
+ "anamnesis.cli" = ["*.tcss"]
62
+ "anamnesis.web" = ["static/*"]
63
+
64
+ [tool.pytest.ini_options]
65
+ asyncio_mode = "auto"
66
+ asyncio_default_fixture_loop_scope = "function"
67
+ testpaths = ["tests"]
68
+ filterwarnings = ["error::RuntimeWarning", "ignore::UserWarning:pydantic.*"]
69
+
70
+ [tool.ruff]
71
+ line-length = 100
72
+ src = ["src", "."]
73
+ target-version = "py311"
74
+
75
+ [tool.ruff.lint]
76
+ select = ["E", "F", "I", "UP", "B", "ASYNC"]
77
+
78
+ [tool.ruff.lint.per-file-ignores]
79
+ "tests/test_ingest.py" = ["E501"] # verbatim fixture records from each tool
80
+
81
+ [tool.mypy]
82
+ python_version = "3.11"
83
+ strict = true
84
+ ignore_missing_imports = true
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
File without changes
File without changes