Does ai-memory use paid AI services?

Can use OpenAI. Its settings have keys for this paid API. Its README says whether one is required.

Is ai-memory still maintained?

Yes, active. Last change today. Latest release v3.4.4, yesterday.

Can I trust ai-memory?

Some track record. 15k stars, 6 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install on macOS

akitaonrails/ai-memory

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

Difficulty: Moderate
Time: about 15 min
Stars: ★ 15,429
Activity: Updated this month

Before you start

Is it free?: YesOpen source (MIT).
Paid AI services?: Can use OpenAIIts settings have keys for this paid API. Its README says whether one is required.
Still maintained?: Yes, activeLast change today. Latest release v3.4.4, yesterday.
Can I trust it?: Some track record15k stars, 6 months old. Get it from the official repo and read what it installs.

Saved setup from 12 h ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Heads-upBuilding it yourself? It also needs 9 settings in .env (2 secret).

Download for macOS

v3.4.4 · 11/8/2026 ↗

ai-memory-macos-aarch64.tar.gz

tar.gz · Apple Silicon · 21.9 MB · 100 downloads · best match

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/akitaonrails/ai-memory/releases/download/v3.4.4/ai-memory-macos-aarch64.tar.gz"
tar -xzf "ai-memory-macos-aarch64.tar.gz"

Other macOS downloads (1)

ai-memory-macos-x86_64.tar.gz

tar.gz · Intel · 23.6 MB · 8 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/akitaonrails/ai-memory/releases/download/v3.4.4/ai-memory-macos-x86_64.tar.gz"
tar -xzf "ai-memory-macos-x86_64.tar.gz"

Install with a package manager

install script

curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh

Pipes a remote script into your shell. Read it before running.

Homebrew

brew install akitaonrails/tap/ai-memory

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Rust 1.95runtime
1×Docker tool

9× settings in .env

AI_MEMORY_LLM_PROVIDER
AI_MEMORY_LLM_BASE_URL
AI_MEMORY_LLM_MODEL
LLM_API_KEYsecret
AI_MEMORY_EMBEDDING_PROVIDERoptional
AI_MEMORY_EMBEDDING_MODELoptional
AI_MEMORY_EMBEDDING_DIMoptional
OPENAI_API_KEYsecretoptional
AI_MEMORY_AUTH_TOKENsecret

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/akitaonrails/ai-memory/badge.svg)](https://gitmanual.com/akitaonrails/ai-memory)

Good to know

Cargo workspace — pick a crate with cargo run -p <name>.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: companions/ai-memory-client/Cargo.toml, companions/ai-memory-desktop/Cargo.toml, companions/ai-memory-importer/Cargo.toml, companions/ai-memory-relay/Cargo.toml and 11 more

Details

License: MIT
Open issues: 87
Branch: main

Files we read (10)

.github/workflows/ci.yml

.github/workflows/codeql.yml

.github/workflows/desktop.yml

.github/workflows/macos-app.yml

.github/workflows/nix.yml

.github/workflows/plugins.yml

Cargo.toml

README.md

docker/.env.production.example

rust-toolchain.toml

1,373 files in the repo