Audrey
About
Persistent memory and continuity engine for Claude Code and AI agents.
Details
- Author
- Evilander
- GitHub stars
- 25
- Downloads
- 367
- Categories
- Other, AI, Developer Tools
Jump to
- Local‑first, no cloud or account required.
- SQLite‑backed memory with semantic recall via sqlite‑vec.
- Preflight checks (allow/warn/block) before tool execution.
- Supports Codex, Claude Code, Cursor, Ollama, and custom agents.
- MCP stdio server, REST API, CLI, and JavaScript/Python SDKs.
- Memory model with episodic, semantic, procedural, decay, and contradiction handling.
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
AudreyCommand (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
Install via npm (requires Node.js 20+). Run npx audrey doctor to verify your setup, then npx audrey demo --scenario repeated-failure to see memory-before-action in action. Use npx audrey guard --tool Bash "npm run deploy" from the terminal, or install into host agents with npx audrey install --host codex (or claude-code, vscode, generic). For programmatic use, import Audrey from the audrey package in JavaScript, or install the Python client (pip install audrey-memory) and connect to the REST sidecar.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"audrey": {
"audrey-memory": {
"command": "npx",
"args": [
"-y",
"audrey",
"mcp"
],
"env": {
"AUDREY_EMBEDDING_PROVIDER": "mock"
}
}
}
}
}McpServers
{
"audrey-memory": {
"command": "npx",
"args": [
"-y",
"audrey",
"mcp"
],
"env": {
"AUDREY_EMBEDDING_PROVIDER": "mock"
}
}
}edit AUDREY_API_KEY in .env
docker compose up -d --build
The Node sidecar defaults to 127.0.0.1:7437. The Docker image intentionally binds inside the container on 3487, so Compose requires AUDREY_API_KEY in .env before startup. Override the published host port with AUDREY_PUBLISHED_PORT when using Compose.
Documentation
- Security policy
- Audrey paper outline
- Public setup, runtime, benchmark, and command guidance is maintained in this README.
Development
Developer setup runs from source, not from the published tarball, so npm run build is required before any CLI subcommand resolves:
npm ci
npm run build
npm run lint # ESLint (type-checked typescript-eslint); CI requires it clean
npm run format # Prettier; use
npm run format:check to verify without writingnpm test
Once built, the Quick Start commands work against the local dist/ output. Code style and types are enforced: npm run lint and npm run format:check run in CI (Ubuntu + Windows) and in every release gate, so the baseline cannot regress. The full release gate runs everything CI runs:
npm run release:gate
python -m unittest discover -s python/tests -v
npm run python:release:check
``
npm test uses a repo-local Vitest launcher so locked-down Windows temp
directories do not block test startup. npm run release:gate:sandbox` remainsavailable for hosts that block child-process spawning entirely.
License
MIT. See LICENSE.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
