TL;DR

Reasonix는 터미널 환경에서 동작하는 DeepSeek-최적화 AI 코드 에이전트로, Go로 재작성된 단일 정적 바이너리를 통해 설치와 배포 마찰을 낮춘다. 구성 파일(reasonix.toml)로 프로바이더와 플러그인을 선언하고 stdio 기반 JSON-RPC(MCP 호환)로 외부 도구를 서브프로세스로 연동하여 개발 작업을 자동화한다. 실행 시 작은 환경 요약을 주입하고 오래된 툴 출력을 프루닝·스니핑해 prefix cache와 함께 긴 세션에서 토큰 비용을 낮추도록 설계되어 있다. 이전의 TypeScript 기반 v0 릴리스는 유지관리용으로 남아 있어 마이그레이션 가이드를 참고해야 한다.

해결 문제

Reasonix는 터미널 중심 워크플로에서 반복적인 프롬프트 계산과 높은 토큰 비용으로 인한 운영 부담을 줄인다. 구성 기반 프로바이더 관리와 플러그인 아키텍처로 모델 교체와 외부 도구 통합을 코드 변경 없이 처리하게 한다. 추가로 단일 정적 Go 바이너리 배포로 설치·업데이트·크로스 플랫폼 배포의 마찰을 낮춘다.

주요 기능

• 구성 파일로 providers, 에이전트, 도구, 플러그인을 선언하여 모델과 툴을 코드 변경 없이 전환할 수 있다.
• 여러 모델을 분리된 캐시 안정 세션으로 실행해 executor와 planner 역할을 병렬로 운영할 수 있다.
• 플러그인을 stdio 기반 JSON-RPC(MCP 호환) 서브프로세스로 연동해 외부 도구 실행과 입출력 통합을 자동화한다.
• 시작 시 환경 요약을 주입하고 오래된 도구 출력을 스니핑·프루닝해 캐시 안정성을 유지하며 긴 세션에서 토큰 비용을 낮춘다.

차별점

• v1에서 TypeScript로 제공되던 기존 구현 대신 Go로 1.0을 처음부터 재작성하여 단일 CGO 없이 크로스 컴파일 가능한 정적 바이너리를 제공한다.
• DeepSeek의 prefix cache 특성을 중심에 두고 세션 안정성·토큰 비용을 직접적으로 최적화하도록 컨텍스트 관리와 요약·프루닝 파이프라인을 설계했다.
• 플러그인 계약과 툴 스키마를 명세화하여 빌트인 도구와 외부 subprocess의 통합 행위를 일관된 방식으로 유지한다.
• 프로바이더를 구성화하여 OpenAI 호환 엔드포인트를 플러그인처럼 교체할 수 있게 하고 두 모델 협업(executor + planner)을 구성으로 손쉽게 구성한다.

지금 주목받는 이유

Go 기반 1.0 재작성과 27,149개에 이르는 GitHub 스타를 바탕으로 활발한 커뮤니티 기여와 관심이 이어지고 있다.

어떻게 동작하는가

Reasonix는 DeepSeek의 prefix cache를 중심 설계로 삼아 동일한 프리픽스에 대해 토큰 재계산을 회피하는 캐시 전략을 활용한다. 에이전트 구성은 reasonix.toml에 선언된 프로바이더와 도구, 플러그인으로 이루어지며 플러그인은 stdio JSON-RPC로 서브프로세스 형태로 실행되어 호스트 환경과 격리된 통신을 수행한다. 실행 시에는 작은 환경 요약을 주입하고 오래된 도구 출력을 잘라내어 요약을 압축함으로써 세션 장기화 시 컨텍스트 크기와 토큰 비용을 제어한다.

사용 사례

• 로컬 터미널에서 코드 수정 제안, TODO 구현, 테스트 추가 같은 반복적 개발 작업을 자동화하는 에이전트로 활용된다.
• 긴 대화형 개발 세션에서 컨텍스트를 유지하면서 토큰 비용을 관리해야 하는 프로젝트 메모리 유지용 도구로 사용된다.
• 데스크톱과 터미널을 연계해 권한·샌드박스 설정이 필요한 봇 통합이나 채널별 승인 워크플로에 연결하는 용도로 활용된다.

시작하기

사전 빌드된 바이너리는 npm 전역 패키지 또는 macOS용 Homebrew로 설치할 수 있으며, 설치 후 reasonix setup으로 프로바이더를 등록하거나 reasonix setup --local로 로컬 프로젝트 설정을 초기화한다. 환경 변수 DEEPSEEK_API_KEY를 설정하거나 setup 명령으로 저장하면 이후 reasonix run 명령으로 자연어 지시를 실행해 코드를 편집하거나 AGENTS.md 형태의 프로젝트 메모리를 생성할 수 있다. 소스에서 빌드하려면 make build로 바이너리를 생성하거나 make cross로 지정된 플랫폼용 교차 컴파일 산출물을 만들면 된다.

요구사항

• 실행은 단일 정적 Go 바이너리로 동작하도록 설계되어 있으며, 빌드 및 배포 시에는 CGO를 비활성화한 환경(CGO_ENABLED=0)으로 크로스 컴파일할 수 있다.
• 런타임 의존성은 최소화되어 있고 README는 유일한 런타임 의존성으로 TOML 파서만 명시하고 있다.
• 프로바이더 연결을 위한 API 키는 환경변수(DEEPSEEK_API_KEY 등)에 저장하거나 Reasonix 홈의 .env에 보관해야 한다.