로컬 지식 그래프를 통한 AI 모델의 영구 메모리.

엔터티, 관계, 관찰을 사용하여 대화 간 정보를 저장하고 검색합니다. Claude Code/Desktop 및 모든 MCP 호환 AI 플랫폼과 호환됩니다.

왜 ".aim"과 “aim_” 접두사가 붙었을까요?

AIM은 AI 메모리의 약자로, 이 시스템의 핵심 개념입니다. 세 가지 AIM 요소는 명확한 조직과 안전성을 제공합니다:

• .aim 디렉터리: AI 메모리 파일을 정리하고 쉽게 식별할 수 있도록 합니다
• aim_ 도구 접두어: 다중 도구 환경에서 관련 메모리 기능을 함께 묶음
• _aim 안전 마커: 각 메모리 파일은 {"type":"_aim","source":"mcp-knowledge-graph"}로 시작하여 관련 없는 JSONL 파일의 우발적인 덮어쓰기를 방지합니다

이러한 일관된 AIM 명명 덕분에 어떤 디렉터리, 도구, 파일이 AI 메모리 시스템에 속하는지 명확히 알 수 있습니다.

중요: .aim 디렉터리와 _aim 파일 마커 이해하기

비슷한 이름의 두 가지 다른 것:

• .aim = 프로젝트-로컬 디렉터리 이름 (프로젝트 감지가 작동하려면 반드시 정확한 이름이 .aim이어야 함)
• _aim = 파일 안전 마커 (JSONL 파일 내에 등장: {"type":"_aim","source":"mcp-knowledge-graph"})

MCP Knowledge Graph

Persistent memory for AI models through a local knowledge graph.

Store and retrieve information across conversations using entities, relations, and observations. Works with Claude Code/Desktop and any MCP-compatible AI platform.

Why “.aim” and “aim_” prefixes?

AIM stands for AI Memory - the core concept of this system. The three AIM elements provide clear organization and safety:

• .aim directories: Keep AI memory files organized and easily identifiable
• aim_ tool prefixes: Group related memory functions together in multi-tool setups
• _aim safety markers: Each memory file starts with {"type":"_aim","source":"mcp-knowledge-graph"} to prevent accidental overwrites of unrelated JSONL files

This consistent AIM naming makes it obvious which directories, tools, and files belong to the AI memory system.

CRITICAL: Understanding .aim dir vs _aim file marker

Two different things with similar names:

• .aim = Project-local directory name (MUST be named exactly .aim for project detection to work)
• _aim = File safety marker (appears inside JSONL files: {"type":"_aim","source":"mcp-knowledge-graph"})

For project-local storage:

• Directory MUST be named .aim in your project root
• Example: my-project/.aim/memory.jsonl
• The system specifically looks for this exact name

For global storage (–memory-path):

• Can be ANY directory you want
• Examples: ~/yourusername/.aim/, ~/memories/, ~/Dropbox/ai-memory/, ~/Documents/ai-data/
• Complete flexibility - choose whatever location works for you

Storage Logic

File Location Priority:

1. Project with .aim - Uses .aim/memory.jsonl (project-local)
2. No project/no .aim - Uses configured global directory
3. Contexts - Adds suffix: memory-work.jsonl, memory-personal.jsonl

Safety System:

• Every memory file starts with {"type":"_aim","source":"mcp-knowledge-graph"}
• System refuses to write to files without this marker
• Prevents accidental overwrite of unrelated JSONL files

Master Database Concept

The master database is your primary memory store - used by default when no specific database is requested. It’s always named default in listings and stored as memory.jsonl.

• Default Behavior: All memory operations use the master database unless you specify a different one
• Always Available: Exists in both project-local and global locations
• Primary Storage: Your main knowledge graph that persists across all conversations
• Named Databases: Optional additional databases (work, personal, health) for organizing specific topics

Key Features

• Master Database: Primary memory store used by default for all operations
• Multiple Databases: Optional named databases for organizing memories by topic
• Project Detection: Automatic project-local memory using .aim directories