https://github.com/timescale/memory-engine
Agentic memory built on Postgres
https://github.com/timescale/memory-engine
agentic-memory bm25 rag semantic-search
Last synced: 22 days ago
JSON representation
Agentic memory built on Postgres
- Host: GitHub
- URL: https://github.com/timescale/memory-engine
- Owner: timescale
- License: apache-2.0
- Created: 2026-03-13T18:22:19.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-18T18:20:53.000Z (about 1 month ago)
- Last Synced: 2026-05-18T20:30:30.242Z (about 1 month ago)
- Topics: agentic-memory, bm25, rag, semantic-search
- Language: TypeScript
- Homepage: https://memory.build
- Size: 1.64 MB
- Stars: 11
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Memory Engine
Permanent memory for AI agents. Store, search, and organize knowledge across conversations.
Memory Engine gives AI coding agents a persistent memory layer they can read from and write to via MCP. Memories are organized with tree paths, tagged with metadata, and searchable by meaning (semantic), keywords (BM25), or both (hybrid via Reciprocal Rank Fusion).
## Install
```bash
curl -fsSL https://install.memory.build | sh
```
Alternative install methods:
### Homebrew
```bash
brew install timescale/tap/me
```
### NPM
```bash
npm i -g @memory.build/cli
```
## Quick start
```bash
# Authenticate
me login
# Store a memory
me memory create "Auth uses bcrypt with cost 12" --tree design.auth
# Search by meaning + keywords
me memory search "how does authentication work"
# Connect to your AI tools
me opencode install
me codex install
me gemini install
me claude install # MCP-only
# Or, for the full Claude Code plugin (hooks + slash commands + MCP):
claude plugin marketplace add timescale/memory-engine
claude plugin install memory-engine@memory-engine
```
## How it works
Memory Engine runs as an MCP server that AI agents connect to over stdio. Each agent gets 10 tools for creating, searching, and managing memories. All data lives in PostgreSQL, using native extensions for search:
- **pgvector** for semantic (vector) search
- **pg_textsearch** for BM25 keyword search
- **ltree** for hierarchical tree paths
- **JSONB + GIN** for metadata filtering
- **tstzrange** for temporal queries
- **Row-Level Security** for access control
## Documentation
- [Getting Started](docs/getting-started.md) -- install, login, first memory
- [Core Concepts](docs/concepts.md) -- memories, tree paths, metadata, search modes
- [Access Control](docs/access-control.md) -- users, roles, grants, ownership
- [Memory Packs](docs/memory-packs.md) -- pre-built knowledge collections
- [MCP Integration](docs/mcp-integration.md) -- connecting AI agents
### Reference
- [CLI Commands](docs/cli/) -- full command reference
- [MCP Tools](docs/mcp/) -- full MCP tool reference
## License
[Apache 2.0](LICENSE)