dezgit2025/auto-memory

auto-memory – AI 코딩 에이전트를 위한 세션 리콜

기능

GitHub Copilot CLI, Claude Code, Codex CLI와 같은 도구가 사용하는 로컬 SQLite 세션 저장소를 읽는 초경량, 제로 의존성 CLI(session-recall 및 백엔드별 명령어)를 제공합니다.
읽기 전에 저장소의 스키마 버전을 확인합니다. 저장소 형식이 변경된 경우(예: 새 OpenAI-Codex 릴리스), 도구는 안전하게 중지하고 복구 워크플로우를 시작할 수 있습니다.
복구는 패키지에 번들된 사전 검토된 수정 또는 Codex CLI(GPT-6 Astra)에 새 리더를 제안하도록 요청하는 AI 지원 수정 중 하나입니다. 후보는 합성 데이터로 테스트되며 적용 전에 사용자 승인을 받아야 합니다.
모든 작업은 읽기 전용입니다. 사용자가 명시적으로 복구를 적용하지 않는 한 원본 세션 데이터베이스는 수정되지 않습니다.

중요성

AI 코딩 에이전트는 세션 저장소 스키마가 변경되면 컨텍스트를 잃습니다. 호환되는 리더가 없으면 에이전트가 '기억상실'처럼 보이며 이전 작업을 기억할 수 없습니다.
auto-memory는 쿼리당 수십 개의 토큰(‘마지막 10개 세션’에 약 50토큰)으로 해당 리콜을 복원하여 과거 작업을 다시 설명하는 데 소비되는 토큰 예산을 크게 줄입니다.

설치 방법

격리된 Python 도구 관리자(권장: pipx 또는 uv)로 한 번 설치합니다. README에 macOS(Homebrew Python 3.14) 및 Linux/WSL용 정확한 명령이 제공됩니다.

설치 후 사용하는 백엔드에 대한 상태 점검을 실행합니다(예:):

session-recall health                     # Copilot CLI
SESSION_RECALL_ENABLE_CLAUDE_BACKEND=1 session-recall-cc health   # Claude Code
session-recall-codex schema-check        # Codex CLI

GitHub 태그 v0.6.0(유일한 릴리스 버전)을 고정하여 릴리스되지 않은 새 커밋을 실수로 가져오지 않도록 합니다.

일반적인 워크플로우

호환성 확인 – session-recall-codex schema-check.
호환 가능한 경우 – 저장소를 쿼리합니다(예: session-recall list --json --limit 10).
호환되지 않는 경우 – session-recall-codex-fix로 복구를 시작합니다. 도구는 다음을 수행합니다:
- 번들된 수정을 찾아 자동으로 적용하거나,
- AI가 제안한 수정을 생성하고 합성 테스트를 실행한 후 diff를 표시합니다.
후보 승인(session-recall-codex-fix approve …) 후 적용합니다. 문제가 발생하면 session-recall-codex-fix rollback …으로 롤백할 수 있습니다.

지원되는 백엔드

백엔드	상태	활성화
GitHub Copilot CLI	✅ 준비됨(기본값)	`session-recall`
Claude Code	🟡 선택 사항(환경 변수 설정)	`session-recall-cc`
Codex CLI	✅ 리콜 + 검토된 복구, 실험적 AI 복구	`session-recall-codex`
VS Code / JetBrains / Neovim	🟡 선택 사항(추가 설치 단계)	`deploy/install-other-backends.md` 참조

대상 사용자

AI 코딩 어시스턴트에 의존하고 에이전트가 다시 프롬프트하지 않고 이전 세션을 기억하기를 원하는 개발자.
여러 AI 백엔드(Copilot, Claude, Codex)를 실행하고 로컬 세션 기록을 노출하는 단일 경량 도구가 필요한 팀.
과거 작업을 반복적으로 다시 설명하여 발생하는 토큰 예산 낭비에 대해 우려하는 모든 사람.

제한 사항

AI 지원 복구 경로는 실험적이며 현재 macOS에서만 작동합니다(sandbox-exec 필요).
이 패키지는 Homebrew 포뮬러를 제공하지 않습니다. 설치 방법은 격리된 Python 환경을 통해서입니다.
이 도구는 읽기 전용이며 명시적으로 복구를 적용하지 않는 한 원본 세션 DB를 수정하지 않습니다.

빠른 시작(사람용)

# 설치(pipx 또는 uv 선택)
pipx install "auto-memory @ git+https://github.com/dezgit2025/auto-memory.git@v0.6.0"
# 설치 확인
session-recall --version
# 백엔드 상태 점검 실행
session-recall health                     # Copilot CLI 예시
# 마지막 10개 세션 나열(약 50토큰)
session-recall list --json --limit 10

빠른 시작(AI 에이전트용)

deploy/install.md를 읽고 단계별 지침을 따릅니다.
requires-user-confirmation 플래그를 존중하고 파일 또는 셸 rc 변경 전에 확인을 요청합니다.
설치 후 적절한 상태 명령을 실행하고 session-recall …을 사용하여 에이전트에게 과거 작업에 대한 기억을 제공합니다.

라이선스: MIT – 자유롭게 사용, 수정, 재배포할 수 있습니다.

dezgit2025/auto-memory

auto-memory – AI 코딩 에이전트를 위한 세션 리콜

빠른 시작(사람용)

빠른 시작(AI 에이전트용)

관련