Quickstart

MIT licensed open source project by AlphaOne LLC.

Fastest install for most people

  1. Install Rust from https://rustup.rs/
  2. Download or clone this repository
  3. Open Terminal in the project folder
  4. Run:
./scripts/install.sh
  1. Then run:
codex-memory health

If you see ok, the daemon is working.

First memory

Run:

codex-memory add \
  --content "I prefer concise technical answers" \
  --kind preference \
  --project-id my-project \
  --tag user

Then verify:

codex-memory search concise --project-id my-project

If something goes wrong

macOS:

launchctl list | grep codex-memory
tail -n 50 ~/Library/Logs/codex-memory/codex-memory.stderr.log

Ubuntu or Fedora:

systemctl --user status codex-memory.service
journalctl --user -u codex-memory.service -n 50

Service control

Linux:

systemctl --user start codex-memory.service
systemctl --user stop codex-memory.service
systemctl --user restart codex-memory.service

macOS:

launchctl load ~/Library/LaunchAgents/com.alphaone.codex-memory.plist
launchctl unload ~/Library/LaunchAgents/com.alphaone.codex-memory.plist

Remove it

./scripts/uninstall.sh