{"name":"ai-memory: Long-Term Memory Solution for AI Coding Agents","description":"ai-memory is a robust solution providing long-term memory for AI coding agents, enabling seamless handoffs between different agent vendors and machines. It ensures that project knowledge, failed approaches, and open questions persist, facilitating collaborative development and continuous progress across various tools and teams. Built in Rust, this open-source project offers a reliable and transparent way to manage agent memory.","github":"https://github.com/akitaonrails/ai-memory","url":"https://osrepos.com/repo/akitaonrails-ai-memory","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/akitaonrails-ai-memory","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/akitaonrails-ai-memory.md","json":"https://osrepos.com/repo/akitaonrails-ai-memory.json","topics":["Rust","AI","Agent Memory","Developer Tools","Open Source","CLI","Collaboration","Long-Term Memory"],"keywords":["Rust","AI","Agent Memory","Developer Tools","Open Source","CLI","Collaboration","Long-Term Memory"],"stars":null,"summary":"ai-memory is a robust solution providing long-term memory for AI coding agents, enabling seamless handoffs between different agent vendors and machines. It ensures that project knowledge, failed approaches, and open questions persist, facilitating collaborative development and continuous progress across various tools and teams. Built in Rust, this open-source project offers a reliable and transparent way to manage agent memory.","content":"## Introduction\n\nai-memory is a powerful, Rust-based open-source project designed to provide long-term memory for AI coding agents. It addresses the common challenge of fragmented agent memory, where knowledge is often confined to a single tool or machine. With ai-memory, your AI agents can maintain a persistent, shared understanding of project context, past attempts, and open questions, enabling seamless transitions between different agent vendors and development environments.\n\nFor more details, visit the official GitHub repository: [akitaonrails/ai-memory](https://github.com/akitaonrails/ai-memory)\n\n## Why use and benefits\n\nai-memory offers several compelling advantages for developers working with AI coding agents:\n\n*   **Cross-Agent Continuity:** It supports over twenty agent harnesses, allowing you to switch between tools like Claude Code, OpenAI Codex, Cursor, and others without losing context. Handoffs become a structured protocol, ensuring the next agent picks up exactly where the previous one left off.\n*   **Cross-Machine Persistence:** Your project's memory resides on a server you control, whether it's your local machine or a homelab. This means you can resume work on any device, accessing the same knowledge and open questions.\n*   **Team Collaboration:** Point multiple team members to a single ai-memory server, and the collective knowledge gained by one person's agents becomes accessible to everyone. It supports multi-user authentication, per-person attribution, and an audit log.\n*   **Plain Markdown Memory:** The core of your memory is a git-backed wiki of ordinary Markdown files. This allows for easy inspection, editing, searching with tools like `grep`, and ensures data is never held hostage in proprietary formats. The database is a derived index, rebuildable from these files.\n*   **Silent Work Capture:** Lifecycle hooks automatically record prompts, tool calls, and session boundaries. This data is sanitized for privacy before storage and consolidated into readable pages, eliminating the need for manual \"remember this\" commands. By default, it operates with zero LLM calls for capture, search, and handoffs.\n*   **Transparent and Reliable:** ai-memory is a self-contained Rust binary, offering clear purge commands, a measured write ceiling, and an audit log of every mutation, providing the reliability expected from infrastructure tools.\n\n## Installation\n\nGetting started with ai-memory is straightforward, with Docker being a highly recommended method for quick setup.\n\n### Docker Quick Start\n\n1.  **Install the `ai-memory` CLI wrapper:** This small shell script runs the binary inside a container, mounting your `$HOME` directory.\n\n    bash\nmkdir -p ~/.local/bin\nwrapper_tmp=\"$(mktemp -d)\"\ntrap 'rm -rf \"$wrapper_tmp\"' EXIT\nwrapper_base=https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-wrapper\ncurl -fsSL \"$wrapper_base\" -o \"$wrapper_tmp/ai-memory-wrapper\"\ncurl -fsSL \"$wrapper_base.sha256\" -o \"$wrapper_tmp/ai-memory-wrapper.sha256\"\nexpected=\"$(awk 'NR == 1 { print $1 }' \"$wrapper_tmp/ai-memory-wrapper.sha256\")\"\nif command -v sha256sum >/dev/null 2>&1; then\n    actual=\"$(sha256sum \"$wrapper_tmp/ai-memory-wrapper\" | awk '{ print $1 }')\"\nelse\n    actual=\"$(shasum -a 256 \"$wrapper_tmp/ai-memory-wrapper\" | awk '{ print $1 }')\"\nfi\n[ -n \"$expected\" ] && [ \"$actual\" = \"$expected\" ] || { echo \"wrapper checksum mismatch\" >&2; exit 1; }\ninstall -m 0755 \"$wrapper_tmp/ai-memory-wrapper\" ~/.local/bin/ai-memory\nrm -rf \"$wrapper_tmp\"\ntrap - EXIT\n# Add ~/.local/bin to your PATH if not already present.\n    \n\n2.  **Start the `ai-memory` server:** This command runs the server in a Docker container. You can optionally configure LLM and embedding providers.\n\n    bash\ndocker run -d --name ai-memory \\\n    --restart unless-stopped \\\n    -p 127.0.0.1:49374:49374 \\\n    -v ai-memory-data:/data \\\n    -e AI_MEMORY_LLM_PROVIDER=anthropic \\\n    -e ANTHROPIC_API_KEY=sk-ant-... \\\n    -e AI_MEMORY_EMBEDDING_PROVIDER=openai \\\n    -e OPENAI_API_KEY=sk-... \\\n    docker.io/akitaonrails/ai-memory:latest\n    \n\n3.  **Wire your agent CLI:** Connect your preferred agent, for example, Claude Code.\n\n    bash\nai-memory install-mcp   --client claude-code --apply\nai-memory install-hooks --agent  claude-code --apply\n    \n\nFor other installation methods, including Arch Linux AUR, native macOS, Windows via WSL2, and more detailed configurations, please refer to the [official installation documentation](https://github.com/akitaonrails/ai-memory/blob/main/docs/install.md).\n\n## Examples\n\nOnce installed and configured, ai-memory integrates seamlessly into your daily workflow:\n\n*   **Continue tasks:** Ask your agent \"where did we leave off?\" to get a summary of the pending handoff.\n*   **Query memory:** Use prompts like \"have we discussed X?\" or \"search memory for Y\" to retrieve information from the project wiki.\n*   **Catch up:** Request \"catch me up\" for a prose digest of recent project activity.\n*   **Managed Workstreams:** Utilize `ai-memory run <agent>` to manage session continuity across different harnesses, allowing you to seamlessly switch between agents while working on the same task.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/akitaonrails/ai-memory](https://github.com/akitaonrails/ai-memory)\n*   **Official Documentation:** [https://github.com/akitaonrails/ai-memory/tree/main/docs](https://github.com/akitaonrails/ai-memory/tree/main/docs)\n*   **Installation Guide:** [https://github.com/akitaonrails/ai-memory/blob/main/docs/install.md](https://github.com/akitaonrails/ai-memory/blob/main/docs/install.md)","metrics":{"detailViews":1,"githubClicks":0},"dates":{"published":null,"modified":"2026-09-10T20:38:06.000Z"}}