Tages

AI 코딩 에이전트를 위한 팀 메모리.

AI 에이전트는 세션 사이에 모든 것을 잊어버립니다. 모든 결정은 다시 논의되고, 모든 규칙은 다시 설명되어야 합니다. 같은 코드를 다루는 다음 에이전트는 이전의 모든 실수를 반복합니다.

개인용 메모리 도구는 증상만 해결할 뿐입니다. 사실을 저장하고 나중에 검색하는 방식이죠. 이는 자신이 무엇을 저장했는지 기억하는 1인 개발자에게는 효과적입니다. 하지만 팀이 AI와 함께 제품을 출시할 때, 즉 세 명의 개발자가 같은 코드베이스에서 에이전트를 사용할 때, 온보딩 시 조직의 지식을 전달해야 할 때, 혹은 아무도 검토하지 않아 잘못된 메모리가 리팩토링 후에도 살아남을 때는 이 방식이 무너집니다.

메모리는 단순한 저장이 아닙니다. 그것은 팀의 관행입니다.

Tages는 코드베이스 메모리를 관리되는 아티팩트로 취급합니다. 구조화된 유형, 품질 점수, 감사 추적, 모호한 메모를 명령형 에이전트 지침으로 다시 작성하는 정교화(sharpen) 과정을 포함합니다. 한 개발자의 아키텍처 결정은 모든 에이전트의 컨텍스트가 됩니다. 잘못된 메모리는 다음 세션을 오도하기 전에 표시되고 수정됩니다.

단 하나의 명령어로 60초 이내에 시작하세요. 워크플로우가 필요로 할 때 팀 기능을 추가하세요.

claude mcp add tages -- npx -y @tages/server

왜 Tages인가?

무엇을 기억하는가

소스 코드는 에이전트에게 무엇이 존재하는지 알려줍니다. Tages는 그 코드가 왜 만들어졌는지, 어떻게 다루어야 하는지, 그리고 무엇을 하지 말아야 하는지를 알려줍니다.

추가: 엔티티, 실행, 운영, 환경, 환경 설정 (총 11가지 유형).

작동 방식

1. 설치 — tages init으로 프로젝트에 연결하거나, 설정이 필요 없는 Claude Code 플러그인을 설치하세요.

2. 기억 — 결정 사항과 규칙을 수동으로, git 훅을 통해, 또는 CLAUDE.md를 가져와서 저장하세요.

3. 회상 — 모든 세션은 로컬 SQLite 캐시에서 10ms 이내에 전체 프로젝트 컨텍스트를 가져옵니다.

설정이 필요 없는 자동 감지

Claude Code 플러그인이나 MCP 서버로 실행할 때, Tages는 현재 어떤 프로젝트에 있는지 자동으로 감지합니다:

1. .tages/config.json — 명시적 마커 파일 (tages link로 생성)

2. Git 원격 저장소 — 등록된 프로젝트와 저장소 이름 일치

3. 디렉토리 이름 — 등록된 프로젝트 슬러그와 폴더 이름 일치

4. 자동 생성 — 인증된 경우 자동으로 새 클라우드 프로젝트 생성; 그렇지 않으면 로컬 전용 모드 사용

디렉토리마다 tages init을 실행할 필요가 없습니다. tages link [slug]를 사용하여 디렉토리를 프로젝트에 명시적으로 바인딩하세요.

Claude Code 플러그인

자동 세션 메모리를 위해 Tages를 Claude Code 플러그인으로 설치하세요:

/plugin https://github.com/ryantlee25-droid/tages

호환성

Claude Code, Cursor, Codex, Gemini 등 MCP를 지원하는 모든 도구와 호환됩니다.

기능

• 56가지 MCP 도구 — 기억, 회상, 감사, 정교화, 가져오기, 연합, 분석 등

• 52가지 CLI 명령어 — 터미널에서 완벽한 제어

• 웹 대시보드 — 다크 모드 UI로 메모 탐색, 검색 및 편집

• 자동 인덱싱 — Ollama 또는 Claude Haiku를 통해 커밋에서 결정 사항을 추출하는 git 훅

• 가져오기 — 기존 CLAUDE.md, ARCHITECTURE.md 또는 JSON 파일에서 시드 데이터 생성

• tages brief — 시스템 프롬프트 주입을 위한 캐시된 컨텍스트 문서 생성

• tages audit — 메모리 커버리지 점수를 매기고 개선 제안 받기

• tages sharpen — 에이전트가 더 잘 이해할 수 있도록 메모리를 명령형으로 다시 작성

• 로컬 우선 — 10ms 미만의 쿼리를 위한 SQLite 캐시, 오프라인 작동

• 하이브리드 검색 — pg_trgm trigram 매칭 + pgvector 의미론적 검색

• 팀 공유 — 여러 개발자가 하나의 코드베이스 메모리를 공유 (Pro)

벤치마크

5번의 직접 비교 벤치마크에서 Tages 컨텍스트를 사용한 에이전트는 사용하지 않았을 때의 2.8/10 대비 최대 9.1/10의 점수를 기록했습니다. 품질 차이는 단순 작업의 +1.0에서 복잡한 작업의 +6.3까지 확장되었습니다. 가장 큰 성과는 규칙 준수, 통합 연결, 함정 회피에서 나타났습니다. 메모리가 없는 에이전트는 기존 하위 시스템에 연결되지 않은 고립된 코드를 지속적으로 생성했습니다.

설정 가이드

• 빠른 시작

• Claude Code

• Cursor

• Codex

• Gemini

• GitHub Actions

• 자체 호스팅

아키텍처

packages/
  server/     MCP server (56 tools, stdio transport, 445 tests)
  cli/        CLI (52 commands, npm global install, 76 tests)
  shared/     TypeScript types + Supabase client
apps/
  dashboard/  Next.js 16, Supabase Auth, Tailwind, shadcn/ui
supabase/
  migrations/ 42 migrations (tables, RLS, pgvector, RBAC, encryption)

보안

• 저장 시 암호화 — 메모리 값에 대해 AES-256-GCM 사용 (옵트인)

• RBAC — 소유자/관리자 쓰기, 멤버 읽기 전용

• 행 수준 보안(RLS) — 모든 테이블은 데이터베이스 계층에서 프로젝트 멤버십을 강제함

• 인증 — Supabase Auth + GitHub OAuth; API 토큰은 만료 시간과 함께 SHA-256 해싱됨

• 비밀 정보 탐지 — 저장 전 메모리에서 API 키, 자격 증명, 개인정보(PII) 스캔

• 감사 로깅 — 인증 이벤트, 내보내기 및 토큰 유효성 검사 추적

전체 보안 정책 및 책임 있는 공개 프로세스는 SECURITY.md를 참조하세요. 개인정보 처리방침은 PRIVACY.md를 참조하세요.

가격

기여

개발 설정 및 가이드라인은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT

이름의 유래

Tages — 땅의 고랑에서 나타나 서기들에게 신성한 지식을 받아쓰게 한 뒤 사라진 에트루리아의 신성한 아이. 그 지식은 근원이 사라진 후에도 오랫동안 지속되었습니다.