빠른 설치

바이너리 설치

mise가 OS와 칩에 맞는 릴리스 아카이브를 내려받고, 공개된 .sha256 파일과 대조해 검증합니다. Rust 툴체인도 Docker도 필요 없습니다.

mise use -g github:akitaonrails/ai-memory

데이터 디렉터리를 만들고 서버 시작

init은 데이터 디렉터리만 만듭니다. serve는 계속 실행되어야 하므로 전용 터미널을 하나 내주세요. 이 컴퓨터에서만 수신하며 토큰은 필요 없습니다.

ai-memory init
ai-memory serve --transport http --bind 127.0.0.1:49374

ai-memory를 통해 에이전트 실행

하네스를 처음 실행할 때 훅과 MCP 항목이 없으면 설치합니다. 그 뒤로 claude를 직접 실행해도 계속 동작합니다.

ai-memory run claude

패키지 설치

-bin 패키지는 미리 빌드된 x86_64 또는 aarch64 바이너리입니다. 두 패키지 모두 systemd용 사용자 유닛과 시스템 유닛을 함께 제공합니다.

yay -S ai-memory-bin    # 미리 빌드된 Linux x86_64/aarch64 바이너리
yay -S ai-memory        # 소스에서 빌드

데이터 디렉터리 만들기

mkdir -p ~/.config/ai-memory ~/.local/share/ai-memory
ai-memory --data-dir ~/.local/share/ai-memory \
  --config ~/.config/ai-memory/config.toml init

사용자 서비스 시작

sudo가 필요 없고, 모든 상태는 홈 디렉터리에 남습니다. 시스템 유닛과 로그아웃 후 실행은 서비스 섹션에서 다룹니다.

systemctl --user enable --now ai-memory.service

ai-memory를 통해 에이전트 실행

ai-memory run claude

다운로드하고 압축 풀기

이 아카이브는 Apple Silicon용입니다. Intel Mac에서는 aarch64를 x86_64로 바꾸세요. 브라우저로 내려받았다면 xattr -d com.apple.quarantine ./ai-memory를 한 번 실행해야 합니다. curl로 내려받았다면 필요 없습니다.

mkdir -p ~/Applications/ai-memory && cd ~/Applications/ai-memory
curl -fsSL -O https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-macos-aarch64.tar.gz
tar -xzf ai-memory-macos-aarch64.tar.gz

데이터 디렉터리를 만들고 서버 시작

이 터미널에서 serve를 계속 실행해 두세요. 대신 launchd 에이전트를 쓰면 로그인할 때 자동으로 시작됩니다.

./ai-memory init
./ai-memory serve --transport http --bind 127.0.0.1:49374

두 번째 터미널에서 에이전트 연결

압축을 푼 바이너리는 그 자리에 그대로 두세요. 훅 명령이 그 경로를 가리킵니다.

cd ~/Applications/ai-memory
./ai-memory install-hooks --agent claude-code --apply
./ai-memory install-mcp --client claude-code --apply

래퍼 스크립트 설치

래퍼는 ~/.local/bin/ai-memory에 설치되는 작은 셸 스크립트입니다. README에 설치 스크립트가 있으며, 이 스크립트는 설치 전에 다운로드한 파일을 SHA-256 파일과 대조해 검증합니다. 거기서 복사해 오세요.

서버 시작

이미지는 linux/amd64와 linux/arm64를 지원합니다. Podman 호스트에서는 docker를 podman으로 바꾸세요. Docker가 설치되어 있지 않으면 래퍼가 알아서 rootless Podman을 씁니다.

docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    docker.io/akitaonrails/ai-memory:latest

에이전트 연결

이후에는 Claude Code를 평소처럼 시작하면 됩니다. 이 경로에는 제약이 하나 있습니다. 래퍼의 셸 훅은 저장소별 ignore_paths 캡처 규칙을 적용하지 않습니다. 네이티브 바이너리는 적용합니다.

ai-memory install-mcp   --client claude-code --apply
ai-memory install-hooks --agent  claude-code --apply

에이전트를 어디서 실행할지 정하기

WSL2 안에서 실행하는 에이전트에는 WSL2 안의 ai-memory가 필요합니다. 이 경로는 지원되며 Docker 탭과 같습니다. WSL2 셸에서 README의 래퍼를 설치하세요. Docker Desktop을 쓴다면 먼저 해당 배포판의 WSL 통합을 켜세요.

WSL2 안에서 서버 시작

docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    akitaonrails/ai-memory:latest

에이전트 연결도 WSL2 안에서

네이티브 Windows는 실험적입니다. ai-memory.exe가 담긴 릴리스 zip, PowerShell Docker 래퍼, WinSW 서비스 레시피가 있습니다. 세 가지 모두 Windows 가이드에 있습니다.

ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply