trailhq/Trail-Code

어떤 프로젝트인가요?

핵심 기능

• 01tree-sitter를 사용해 모델 없이 파일, 함수, 호출자로 구성된 로컬 코드 그래프를 만듭니다.
• 02각 쿼리마다 코드 지도를 갱신해 커밋하지 않은 수정 사항도 반영합니다.
• 03학습 내용을 저장소의 markdown 파일로 저장하고, pull request를 통해 검토합니다.
• 04trail check를 실행해 PR을 올리기 전에 브랜치와 기록된 학습 내용을 비교합니다.
• 05개인 학습 내용은 ~/.trail에 저장하며, 커밋되지 않습니다.
• 06TypeScript, Python, Go, Java, Rust를 포함한 24개 언어를 지원합니다.

활용 사례

• Claude Code나 Cursor에 대규모 코드베이스 지도를 제공해 열어 보는 파일 수를 줄입니다.
• 설계 결정을 내린 이유를 기록해 이후 에이전트 세션에서 해당 결정을 되돌리지 않도록 합니다.
• 병합 전에 팀원이 기록한 결정과 충돌하는 변경 사항을 찾아냅니다.
• 에이전트가 익숙하지 않은 저장소에서 작업할 때 토큰 사용량과 세션 시간을 줄입니다.

빠른 시작

1. 1

   npm에서 CLI를 전역으로 설치하세요

   npm install -g @trailhq/trail-code
2. 2

   저장소에서 코드 맵을 만들고 에이전트 연결을 설정하세요

   trail init

사용 전 알아둘 점

• !Trail-code를 사용하려면 Node 22.3 이상이 필요합니다(20.16도 작동합니다). 그보다 오래된 Node 환경은 먼저 업그레이드해야 합니다.
• !학습 내용은 저장소 안의 파일로 저장되며, 개인 학습 내용은 사용자의 컴퓨터에 저장됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

Trail-Code은(는) 무엇인가요?

Claude Code와 Cursor 같은 코딩 에이전트에 코드베이스 지도와 팀이 내린 결정을 제공하는 자기 학습형 컨텍스트 레이어입니다. Trail-code(구 graft)는 코딩 에이전트에 코드 지도와 학습 내용 저장소, 두 가지를 제공합니다. 코드 지도는 tree-sitter를 사용해 로컬에서 만들며 모든 파일, 함수, 호출자를 기록하므로 에이전트가 관련 코드를 찾고 변경 사항이 어떤 부분에 영향을 줄지 파악할 수 있습니다. 이 기능에는 모델이나 API 키가 필요하지 않으며, 커밋하지 않은 수정 사항을 포함해 파일이 변경될 때마다 최신 상태로 갱신됩니다.

Trail-Code은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Trail-Code은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Trail-Code은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Trail-Code의 마지막 커밋은 2026년 11월 6일입니다.

Trail-Code은(는) 어디에 사용할 수 있나요?

Claude Code나 Cursor에 대규모 코드베이스 지도를 제공해 열어 보는 파일 수를 줄입니다. 설계 결정을 내린 이유를 기록해 이후 에이전트 세션에서 해당 결정을 되돌리지 않도록 합니다. 병합 전에 팀원이 기록한 결정과 충돌하는 변경 사항을 찾아냅니다. 에이전트가 익숙하지 않은 저장소에서 작업할 때 토큰 사용량과 세션 시간을 줄입니다.

Trail-Code는 어떻게 설치하나요?

npm에서 CLI를 전역으로 설치하세요: npm install -g @trailhq/trail-code 저장소에서 코드 맵을 만들고 에이전트 연결을 설정하세요: trail init

Trail-Code은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/trailhq/Trail-Code