Mibayy/token-savior

해결하는 문제

Token Savior는 일반적으로 간단한 질문에 답하기 위해 전체 파일을 읽거나 세션 간에 컨텍스트를 잃는 AI 코딩 에이전트(Claude Code 등)와 관련된 막대한 토큰 소비와 비용을 줄이기 위해 설계되었습니다. 주로 세 가지 문제를 해결합니다: 비효율적인 코드베이스 탐색, 세션 간 지속적 메모리 부족, 그리고 턴 예산을 소모하는 과도한 Bash 출력.

작동 방식

이 프로젝트는 여러 최적화 계층을 제공하는 Model Context Protocol (MCP) 서버를 구현합니다.

• 구조적 코드 탐색: 전체 파일을 읽는 대신, 심볼(함수, 클래스, 임포트, 콜 그래프)로 코드베이스를 인덱싱하여 에이전트가 특정 코드 세그먼트로 포인터를 통해 이동할 수 있게 합니다.
• 지속적 메모리 엔진: SQLite(WAL + FTS5)와 벡터 임베딩을 사용하여 결정, 버그 수정, 규칙을 저장하고, 새로운 세션 시작 시 컴팩트한 델타로 다시 주입합니다.
• Bash 최적화:
  • PreToolUse 리라이터: 도구 실행 전에 Bash 명령을 수정하여 더 작고 토큰 효율적인 출력을 생성합니다.
  • PostToolUse 컴팩터: 도구가 반환한 후 Bash 출력을 토큰 효율적인 형식으로 렌더링하며, 이후 쿼리 가능하도록 캡처 사ンド박스에 전체 출력을 보존합니다.

대상 사용자

API 비용을 낮추고, 지연을 줄이며, 다양한 세션 간에 컨텍스트를 유지할 수 있도록 하고자 하는 개발자들로, Claude Code, Cursor, Gemini, Codex 등의 AI 코딩 에이전트를 사용하는 경우에 적합합니다.

주요 특징

• 매우 큰 토큰 감소: tsbench 벤치마크에서 작업당 활성 토큰이 80% 감소한 것으로 보고되었습니다.
• 큐레이션 프로파일: optimized, tiny, full 등 다양한 프로파일을 제공하여 노출되는 도구 수와 매니페스트 토큰 비용의 균형을 조절할 수 있습니다.
• 광범위한 Bash 지원: git, gh, kubectl, docker, 다양한 테스트/라인트 프레임워크 등 34개의 다양한 컴팩터를 포함합니다.
• 에이전트 독립성: Claude Code에 최적화되어 있지만, Cursor나 Aider와 같은 비-MCP 에이전트를 위한 CLI도 제공합니다.