Aimemo
About
# aimemo [](https://golang.org/) [](LICENSE)…
Details
- License
- MIT
Explore
- Single binary, no Docker, Node.js, cloud, or API keys.
- Memory stored in .aimemo/ next to project code, portable across branches.
- Auto-loads prior context via memory_context tool at session start.
- Full-text search using SQLite FTS5 with BM25 scoring (recency + frequency).
- Concurrent writes supported via SQLite WAL mode.
- Full CLI control: inspect, edit, retract, export Markdown or JSON.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AimemoCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
| Command | Description |
|---------|-------------|
| aimemo init | Create .aimemo/ in the current directory |
| aimemo serve | Start the MCP stdio server (called by Claude Code automatically) |
| aimemo doctor | Verify DB health, FTS5 support, WAL mode, and MCP registration |
curl -sSL https://raw.githubusercontent.com/MyAgentHubs/aimemo/main/install.sh | bash
If you're using OpenClaw skills, see the OpenClaw Integration section below for per-skill memory isolation.
~/.aimemo/config.toml — global defaults, all optional:
[defaults]
context = "main" # default context name
max_results = 20 # observations returned by memory_context
[scoring]
recency_weight = 0.7 # 0–1, weight of recency vs. access frequency
[server]
timeout_ms = 5000 # hard timeout on every MCP call
log_level = "warn" # "debug" | "info" | "warn" | "error"
Per-project overrides live in .aimemo/config.toml in the project root — same keys, project values win over global values.
curl -sSL https://raw.githubusercontent.com/MyAgentHubs/aimemo/main/install.sh | bash
memory_context
Returns ranked, recent observations for the current project
memory_store
Saves an observation (fact, decision, journal entry, TODO)
memory_search
Full-text search across all observations, BM25-ranked
memory_forget
Soft-deletes an observation by ID
memory_link
Creates a named relationship between two observations
| Tool | Description | When Claude calls it |
|------|-------------|----------------------|
| memory_context | Returns ranked, recent observations for the current project | Session start — automatic |
| memory_store | Saves an observation (fact, decision, journal entry, TODO) | After completing a task or making a decision |
| memory_search | Full-text search across all observations, BM25-ranked | When it needs to recall something specific |
| memory_forget | Soft-deletes an observation by ID | When instructed to discard something |
| memory_link | Creates a named relationship between two observations | When it identifies a dependency or connection |
All tool schemas total under 2,000 tokens. Each call has a hard 5-second timeout — the server never stalls your session. Empty-state queries return in under 5 ms.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"aimemo": {
"aimemo": {
"command": "aimemo",
"args": []
}
}
}
}McpServers
{
"aimemo": {
"command": "aimemo",
"args": []
}
}
Zero-dependency MCP memory server for AI agents — persistent, searchable, local-first, single binary.
$ claude "let's keep working on the payment service"
╭─ memory_context ──────────────────────────────────────────────────╮
│ [project: payment-service] │
│ │
│ Last session (3 days ago): │
│ • Stripe webhook signature verification — DONE │
│ • Idempotency key refactor — IN PROGRESS │
│ • Blocked: race condition in concurrent refund handler │
│ │
│ Related: Redis connection pool, pkg/payments/refund.go │
╰───────────────────────────────────────────────────────────────────╯
Picking up where we left off. The race condition in the refund
handler looks like a missing mutex around the in-flight map.
Let me check pkg/payments/refund.go ...
[... Claude works through the fix ...]
╭─ memory_store (journal) ──────────────────────────────────────────╮
│ Resolved refund race — added sync.Mutex around inFlightRefunds. │
│ Tests passing. Next: load test with k6 at 500 rps. │
╰───────────────────────────────────────────────────────────────────╯
🧠 Why aimemo
- No infra to babysit. Single Go binary. No Docker, no Node.js runtime, no cloud account, no API keys. brew install in 30 seconds.
- Memory stays with the project. Stored in .aimemo/ next to your code — commit it to git or add it to .gitignore. Switch branches; memory follows the directory.
- Claude picks up exactly where it left off. memory_context fires automatically on every session start. Claude sees what it was doing, what was blocked, what decisions were made. You stop repeating yourself.
- Full-text search that ranks correctly. FTS5 + BM25 scoring weighted by recency and access frequency. Relevant memories surface first; old noise fades naturally.
- Concurrent sessions, no corruption. SQLite WAL mode lets multiple Claude windows write simultaneously without locking each other out.
- You stay in control. Every tool Claude has, you have from the terminal. Inspect, edit, retract, export. Your memory is readable Markdown or JSON — never locked in a proprietary format.
⚡ Quick Start
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
