OpenCode 토큰 사용량을 최대 80% 절감하는 라이브러리 'CTX' 개발
I created a library for OpenCode that allows you to save up to 80% of your tokens
핵심 요약
코딩 에이전트의 불필요한 컨텍스트 소모를 줄여 토큰 효율을 극대화하는 로컬 우선 런타임 'CTX'를 소개함.
- CTX 라이브러리 — 코딩 에이전트가 불필요한 정보를 읽지 않도록 로컬에서 컨텍스트를 최적화함.
- 토큰 효율성 — 그래프 메모리와 로그 가지치기를 통해 프롬프트 토큰 사용량을 최대 80%까지 절감함.
- OpenCode 통합 — OpenCode 환경 내에서 명령어를 통해 프로젝트 규칙과 관련 코드 조각을 효율적으로 검색함.
- 오픈 소스 공개 — 현재 macOS Apple Silicon 환경을 지원하며 오픈 소스로 배포되어 피드백을 기다리는 중임.
저는 22살 컴퓨터 과학 전공 학생이고, 최근에 CTX라는 오픈 소스 프로젝트를 만들었습니다.
코딩 에이전트(Claude, Codex 등)를 사용하면서 계속 보게 된 문제에서 아이디어를 얻었습니다.
에이전트들은 강력하지만, 잘못된 정보에 컨텍스트를 너무 많이 낭비합니다.
거대한 AGENTS.md 파일, 시끄러운 로그, 광범위한 diff, 너무 많은 저장소 구조, 반복되는 프로젝트 지침을 계속 다시 읽습니다.
그래서 모델이 아무리 좋아도 프롬프트 예산의 상당 부분이 실제 문제 해결이 아닌 컨텍스트 낭비에 쓰입니다.
그래서 제가 CTX를 만들었습니다.
What CTX is
CTX는 코딩 에이전트를 위한 로컬 우선 컨텍스트 런타임이며, 특히 OpenCode(현재 기준)를 위해 설계되었습니다.
모델이나 코딩 에이전트를 대체하지 않습니다.
대신 그 아래에서 에이전트가 다음 작업을 수행하도록 돕습니다:
- 프로젝트 규칙 및 지침을 위한 그래프 메모리
- 작업별로 압축된 컨텍스트 팩
- 코드, 심볼, 스니펫 및 메모리에 대한 검색
- 근본 원인을 더 빨리 파악하기 위한 로그 가지치기
- 로컬 MCP 통합
- 로컬 전용 통계 및 감사 추적
따라서 전체 마크다운 지침과 거대한 로그를 프롬프트에 반복적으로 덤프하는 대신, CTX는 현재 작업에 가장 유용한 최소한의 조각만 검색하도록 돕습니다.
Why I made it
코딩 에이전트가 덜 시끄럽고 더 신중하게 느껴지길 바랐습니다.
목표는 다음과 같습니다:
- 프롬프트 낭비 감소
- 수동 컨텍스트 관리 감소
- 실제로 관련성 있는 프로젝트 지식 검색 개선
- 시끄러운 테스트 출력에서 더 나은 디버깅 신호 확보
- OpenCode 내에서 네이티브하게 느껴지는 워크플로우
How it works
흐름은 의도적으로 단순합니다:
- install
ctx - go into your repo
- run:
ctx init
ctx index
ctx opencode install
opencode
그런 다음 OpenCode 내부에서 다음과 같은 명령어를 사용할 수 있습니다:
/ctx #Opens the CTX command center inside OpenCode.
/ctx-doctor #Checks whether CTX, MCP, and the repo setup are working correctly.
/ctx-memory-bootstrap #Imports project guidance files into graph memory for targeted retrieval.
/ctx-memory-search #Searches stored project rules and directives by topic or keyword.
/ctx-retrieve #Finds the most relevant code, symbols, snippets, and memory for a task.
/ctx-pack #Builds a compact task-specific context pack for the current problem.
/ctx-prune-logs #Condenses noisy command output into the most useful failure signal.
/ctx-stats #Shows local usage stats and context-efficiency metrics.

