프로젝트 소개

Reasonix는 MIT 라이선스의 오픈소스 AI 코딩 에이전트로, DeepSeek를 중심으로 단일 자가 포함 Go 바이너리로 배포됩니다. README는 이를 "끊임없이 실행해 둘 수 있는 코딩 에이전트"로 포지셔닝하며, 로컬 엔진은 네 가지 방법으로 접근 가능합니다: 터미널(CLI/TUI), 데스크탑 앱, 브라우저, 그리고 에이전트 클라이언트 프로토콜(ACP)을 통한 에디터. 주요 문서화된 기능: - 구성 기반 설계: 제공자, 에이전트, 활성화된 도구와 플러그인은 `reasonix.toml`에 선언되며 하드코딩된 모델이 없습니다. DeepSeek는 프리셋으로 제공되며, 모든 OpenAI 호환 엔드포인트는 구성 항목으로 추가할 수 있습니다. 두 개의 모델(executor + planner)은 선택적으로 별도 캐시 안정 세션에서 함께 실행될 수 있습니다. - 플러그인 기반 확장성: MCP 서버는 도구, 프롬프트 및 리소스를 기여하며, Extension Protocol v1 사이드카는 런타임 이벤트에 인터셉트, 제공자 기여, 구조화된 UI, 버전별 플러그인 패키지Shipping을 지원합니다. Go SDK와 starter가 제공됩니다. - 캐시 인식 컨텍스트 유지: 시작 시 작은 안정적인 환경 요약이 주입되며, 낡은 도구 출력은 요약 압축 전 트리밍되거나 요약됩니다. 빌트인 도구 스키마 계약은 회귀 검토를 위해 문서화됩니다. - 장기 실행 안전 기능: 계획 모드, 권한, 워크스페이스 샌드박스, 되감기 가능한 턴별 체크포인트는 자율 실행을 읽기 쉽고 되돌릴 수 있도록 의도되었습니다. README에 설명된 설치 경로: - 경로 A(CLI/TUI): 지원되는 모든 플랫폼에서 `npm i -g reasonix`, 또는 macOS의 Homebrew(`brew install esengine/reasonix/reasonix`). darwin/linux/windows용 사전 구축 아카이브는 amd64/arm64에 SHA256SUMS와 함께 GitHub 릴리스에 첨부됩니다. - 경로 B(데스크탑 앱): macOS(범용 .dmg/.zip), Windows(.exe 설치 프로그램 또는 휴대용 .zip, x64/ARM64), Linux(.deb/.tar.gz, x64)용 다운로드. Windows 설치 프로그램은 SignPath.io를 통해 코드 서명됩니다. - 경로 C(VS Code 확장): 경로 A가 먼저 필요하며, 이 확장은 로컬 `reasonix acp` 백엔드를 시작하고 채팅, 에디터 컨텍스트, 도구 호출 승인, 모델 선택, 워크스페이스 세션을 추가합니다. Visual Studio Marketplace와 Open VSX(확장 ID `SivanLiu.reasonix-agent`)에서 사용 가능합니다. - 경로 D(소스에서 빌드): CLI 빌드는 Go 1.26+와 `GOTOOLCHAIN=auto`가 필요하며, `make build`와 `make cross`는 여섯 대상에 대한 바이너리를 생성합니다. 데스크탑 빌드는 Node 24+와 pnpm 10이 추가로 필요하며 자체 Chromium을_ship하여 플랫폼 webview 종속성이 필요하지 않습니다. CLI 빠른 시작에는 제공자와 모델을 구성하는 `reasonix setup`, 대화형 세션을 위한 `reasonix`, 한번 실행 작업을 위한 `reasonix run "..."`, 세션 내 프로젝트 지침을 생성하는 `/init`이 포함됩니다. 데스크탑 앱은 앱 내에서 구성되며 CLI 명령어가 필요하지 않습니다. 문서에는 CLI 참조, 가이드, 구성 경로, ACP 에디터 통합, 서브에이전트 프로필, Context Engine v2, 기능 진단, 복구 및 업데이트, 봇 가이드, 체크포인트 및 되감기, 사양, 작업 계약과 일시 중단 정책, 도구 계약, 0.x 마이그레이션, 확장 개발, 플러그인 패키지 및 Manifest v1, Extension Protocol이 포함됩니다. 프로젝트는 영어와 간체 중국어로 제공되며, 설치 도움과 워크플로 쇼케이스를 위한 Discord 커뮤니티를 호스팅합니다.