Code graph and memory for your coding agents, in one Rust program. For Claude Code, Codex, Cursor and any MCP client.

Graphicle – AI 코딩 어시스턴트를 위한 로컬 Rust 기반 코드 그래프 및 메모리 엔진

무엇인가요

Graphicle은 Rust로 작성된 단일 바이너리 오픈 소스 도구로, 리포지토리의 코드 그래프(파일, 함수, 클래스, 호출, 임포트)를 구축하고 프로젝트 전반의 문서, 의사 결정 및 과거 코딩 어시스턴트 세션을 저장합니다. 데이터는 개발자 컴퓨터의 SQLite 파일 하나에 저장되므로 외부 데이터베이스, Docker 컨테이너 또는 클라우드 서비스가 필요하지 않습니다.

AI 지원 개발에서 중요한 이유

온디맨드 인용 컨텍스트 – 코딩 에이전트(Claude Code, Cursor, Codex, VS Code 등)가 질문을 하면, Graphicle은 답변이 되는 정확한 파일 및 라인 발췌문을 설정한 토큰 예산 내에서 반환합니다. 에이전트를 구동하는 모델이 해당 발췌문을 읽으므로 답변을 검증할 수 있습니다.
로컬 우선 및 개인정보 보호 – API 키, 계정 또는 텔레메트리가 필요하지 않습니다. 모든 인덱싱, 검색 및 메모리는 개발자의 컴퓨터에 상주하며, 선택적인 모델 호출(예: Anthropic, OpenAI, Ollama)만 외부로 나갑니다.
속도 및 메모리 효율성 – 리포지토리의 벤치마크에 따르면 0.1.1 프리릴리스 엔진은 13개의 실제 코드베이스에서 동급 Python 도구인 Graphify보다 3배~22배 더 빠르고 0.3배~0.97배 더 적은 피크 메모리를 사용합니다.
원스톱 설치 – 단일 brew install(또는 스크립트)로 코드 그래프 빌더, 메모리 서버, MCP(Multi-Client Protocol) 서버, 웹 UI 및 CLI를 모두 제공합니다. Python, Docker 또는 별도의 데이터베이스가 필요하지 않습니다.

핵심 기능 (README 설명 기준)

기능	설명
코드 그래프	tree-sitter를 사용하여 소스를 파싱하고 파일, 심볼, 호출, 임포트를 기록합니다. CLI(`graphicle graph …`) 및 대화형 HTML 뷰를 제공합니다.
프로젝트 메모리	Markdown, PDF, Office, HTML 문서 및 과거 Claude Code / Codex 세션을 인덱싱합니다. 메모리는 설명하는 심볼과 연결되며 코드가 변경되면 만료됩니다.
인용 컨텍스트	`graphicle ask` / `graphicle context`는 모델을 호출하지 않고도 파일 이름과 라인 범위 인용이 포함된 발췌문을 토큰 예산 내에서 반환합니다.
MCP 서버	그래프 및 메모리 도구를 MCP 프로토콜을 통해 노출하여 호환되는 모든 클라이언트(Claude Code, Cursor, VS Code 등)가 호출할 수 있도록 합니다.
세션 캡처	코딩 어시스턴트의 완료된 각 턴을 기록합니다. 검토된 메모리는 저장되어 나중에 새로운 세션에서 자동으로 제공됩니다.
Git 통합	Git 훅을 설치하여 답변 전 변경된 파일을 동기화하고 수정된 모든 파일을 백업(`*.graphicle-bak`)합니다.
교차 리포지토리 워크스페이스	`graphicle context --workspace`는 워크스페이스 내의 여러 리포지토리에 걸쳐 작동할 수 있습니다.
웹 UI	`graphicle open`은 그래프, 소스 파일 및 메모리를 보여주는 브라우저 뷰를 실행하며, 여기서 메모리를 승인할 수 있습니다.
개인정보 보호 제어	`.gitignore`를 준수하고, 비밀 정보를 건너뛰며, 개인 정보를 가리고, 일일 릴리스 확인 요청만 수행합니다(`GRAPHICLE_NO_UPDATE_NOTIFIER`를 통해 거부 가능).

누가 사용하나요?

개발자: LLM 기반 코딩 어시스턴트에 의존하며 어시스턴트의 제안에 대해 결정적이고 검증 가능한 인용을 원하는 분.
팀: 작업 중인 코드의 정확한 버전과 연결된 공유 로컬 지식 베이스(문서, 의사 결정, 이전 어시스턴트 세션)가 필요한 팀.
도구 제작자: 모든 에디터나 IDE에서 MCP를 통해 액세스할 수 있는 빠르고 Rust 네이티브인 코드 그래프 백엔드를 원하는 분.

시작하기 (README의 퀵스타트)

설치 – brew install graphicle-ai/tap/graphicle (또는 한 줄짜리 curl 스크립트).
리포지토리 인덱싱 – cd your-repo && graphicle setup. 그래프를 구축하고 현재 세션을 캡처하며 AGENTS.md에 짧은 항목을 추가하고 Git 훅을 설치합니다.
질문하기 – graphicle ask "where is tax added to prices?" – 인용된 발췌문을 볼 수 있습니다. 모델을 구성(graphicle config set model anthropic)하면 전체 답변을 얻을 수 있습니다.
탐색 – graphicle open (브라우저 UI), graphicle graph extract . --code-only, graphicle graph affected "retry()".
실행 취소 – graphicle disconnect는 훅을 제거하고 백업된 파일을 복원합니다.

제한 사항 및 현재 상태 (README 기준)

Windows 빌드는 미리보기이며 아직 코드 서명이 되어 있지 않습니다.
벤치마크는 프리릴리스 빌드(0.1.0/0.1.1)를 기반으로 하며 엔진은 계속 발전 중입니다.
토큰 예산 처리는 인용된 컨텍스트의 양만 제한하며, 최종 답변의 품질은 구성한 다운스트림 LLM에 따라 달라집니다.
장기 실행 세션 및 대규모 메모리 축적은 아직 완전히 테스트되지 않았습니다.

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며, 외부적인 가정은 추가되지 않았습니다.

Graphicle-AI/graphicle