Reasonix CLI

DeepSeek 네이티브 통합 및 캐시 친화 컨텍스트

Reasonix는 api.deepseek.com에 직접 연결되며, DeepSeek의 바이트-stable prefix cache를 중심으로 설계되어 긴 세션에서도 90% 이상의 캐시 적중률을 유지하고 입력 토큰 비용을 약 1/5 수준으로 낮춥니다. 시작 시 안정적인 환경 요약을 주입하고, 요약 압축 전에 오래된 도구 출력을 정리해 캐시 효율을 유지합니다.

plan mode와 도구 호출 권한 제어

/plan 명령은 사용자가 계획을 읽고 승인하기 전까지 모든 쓰기 작업을 보류시킵니다. 읽기·쓰기·셸 명령은 각각 별도로 승인 요청이 발생하며, 작업 영역 샌드박스는 명령이 접근할 수 있는 범위를 추가로 제한합니다.

turn 단위 체크포인트

각 turn은 git 외부에 체크포인트를 기록하여, 6시간 이상 자율 실행이라 해도 커밋 기록에 영향을 주지 않고 임의 시점으로 되감을 수 있습니다. 각 체크포인트는 개별적으로 검토하거나 되돌릴 수 있습니다.

구성 기반 다중 모델 및 플러그인 확장

Reasonix.toml에서 제공자, 에이전트, 활성 도구, 플러그인을 선언하며 하드코딩된 모델이 없습니다. DeepSeek는 프리셋으로 포함되고, OpenAI 호환 엔드포인트는 모두 설정 항목으로 등록할 수 있습니다. MCP 서버(stdio, SSE, streamable HTTP)는 도구·프롬프트·리소스를 단일 레지스트리에 합치고, 마크다운 스킬과 explore·research·review·security-review 같은 서브에이전트는 각자의 격리된 도구 세트를 갖습니다.

다중 진입점

단일 로컬 엔진이 터미널(TUI), 데스크탑 앱, 브라우저(reasonix serve), ACP를 통한 편집기 확장의 네 가지 진입점을 공유합니다. 한쪽에서 시작한 세션의 권한·스킬·MCP 서버 상태가 다른 쪽에서도 그대로 이어집니다.

설치 및 기본 사용

운영 체제에 맞는 설치 경로를 선택하면 됩니다.

• CLI/TUI (npm): `npm i -g reasonix`으로 어디서나 네이티브 바이너리를 받거나, macOS에서는 Homebrew로 설치할 수 있습니다.
• Windows (winget): `winget install –id ESEngine.ReasonixCLI –exact` 명령으로 설치합니다.
• VS Code 확장: 먼저 로컬에 Reasonix를 설치·구성한 뒤, VS Code Marketplace 또는 Open VSX에서 확장 ID SivanLiu.reasonix-agent를 설치합니다. 확장은 reasonix acp 백엔드에 연결되며 CLI를 번들하지 않습니다.
• 소스 빌드: 저장소를 클론한 뒤 `make build`로 CLI를, `make wails-install` 후 `wails build`로 데스크탑 앱을 빌드할 수 있습니다.

설치 후 CLI에서는 다음 흐름으로 바로 사용할 수 있습니다.

1. `reasonix setup`으로 제공자와 모델을 구성합니다.
2. `reasonix`로 대화형 세션을 시작합니다.
3. `reasonix run “implement the TODOs in main.go”`처럼 한 줄 작업도 직접 실행할 수 있습니다.

대화형 세션 안에서는 `/init`을 입력해 프로젝트 지침을 만들 수 있고, `/plan`으로 쓰기 전에 계획을 검토할 수 있습니다. 브라우저에서 같은 세션을 보려면 `reasonix serve`로 로컬 웹 UI를 띄우며, 노출 전에 token/password 인증을 켜는 것이 권장됩니다.

활용 예시

터미널에서 한 줄 명령으로 다중 파일 리팩토링을 지시하면, Reasonix는 plan을 제시하고 각 편집·테스트 실행에 대해 단계적으로 권한 요청을 합니다. 각 turn이 체크포인트로 남기 때문에, 결과가 마음에 들지 않을 때는 임의 시점으로 안전하게 되돌릴 수 있습니다. 같은 작업을 VS Code 확장에서 이어받으면 편집기 컨텍스트와 도구 호출 승인이 추가되며, 데스크탑 앱에서는 여러 세션을 나란히 두고 diff와 체크포인트를 시각적으로 검토할 수 있습니다.

지원 환경 및 요구사항

단일 Go 바이너리는 macOS·Linux·Windows × amd64/arm64로 교차 컴파일됩니다. macOS/Linux/WSL에서는 npm 글로벌 설치 또는 Homebrew, Windows에서는 npm 설치 또는 winget으로 받을 수 있습니다. 공식 데스크탑 빌드는 macOS Universal DMG, Windows 10+ 설치 프로그램(x64/ARM64), Linux용 .deb 및 tar.gz로 제공됩니다. Windows 설치 프로그램은 SignPath Foundation에서 무료로 발급한 인증서로 SignPath.io를 통해 코드 서명됩니다.

제한 및 라이선스 확인사항

Reasonix는 MIT 라이선스로 배포되며 저장소 내 LICENSE에서 전문을 확인할 수 있습니다. DeepSeek API를 직접 호출하므로 본인 DeepSeek API 키가 필요하고, v1.31.3에서는 새 비전 SKU `deepseek-v4-flash-vision-exp`에 대한 DeepSeek 과금이 적용됩니다. 데스크탑 앱을 외부로 노출할 때는 `reasonix serve –auth token`으로 인증을 활성화해야 하며, macOS 다운로드본을 `/Applications`에 설치한 후 quarantine 속성을 제거해야 할 수 있습니다.

자주 묻는 질문

• Q. Reasonix CLI를 어떤 환경에서 실행할 수 있나요?
  A. macOS·Linux·Windows(WSL 포함)에 대해 사전 빌드된 단일 Go 바이너리가 제공되며, Windows에서는 winget, macOS·Linux에서는 npm과 Homebrew로 설치할 수 있습니다.
• Q. 실행하려면 DeepSeek 계정이 필요한가요?
  A. 예. 본인 DeepSeek API 키로 api.deepseek.com에 직접 연결하는 방식이며, 코드는 사용자가 구성한 모델로만 전송됩니다.
• Q. 어떻게 설치하나요?
  A. `npm i -g reasonix` 또는 macOS의 경우 `brew install esengine/reasonix/reasonix`, Windows에서는 `winget install –id ESEngine.ReasonixCLI –exact`를 사용할 수 있습니다.
• Q. 장시간 실행 중 잘못된 변경을 어떻게 되돌리나요?
  A. 모든 turn이 git 외부에 체크포인트를 기록하므로 임의 시점으로 되감을 수 있고, plan mode에서는 승인 전까지 쓰기가 보류됩니다.
• Q. v1.31.3의 핵심 변경점은 무엇인가요?
  A. 공식 DeepSeek 비전 모델 입력 지원, 네트워크 검색 출처 패널 정리, 세션 전환 시 transcript 깜빡임 수정이 포함되며 수동 마이그레이션은 필요하지 않습니다.