ONEDEV

Codewhale

AI Coding ToolsTUIRust

★ 40,955주당 +79조회 6

무엇인가

Codewhale은 저장소를 읽고 파일을 편집하고 명령을 실행하는 에이전트를 터미널에서 돌리는 도구다. 에이전트 실행과 도구 호출은 Codewhale Runtime이 담당하고, 터미널 TUI·로컬 웹 클라이언트·그래픽 앱이 이 런타임에 접속하는 클라이언트가 된다. 편집기 안에 붙는 어시스턴트가 아니라 저장소 폴더를 작업 단위로 삼는 실행 환경 쪽에 속한다.

어떻게 동작하나

TUI 안에서는 `/provider`로 제공자를, `/model`로 모델을 고른다. `/mode plan`은 파일 변경과 셸 실행 없이 탐색만 하고, `/mode work`는 변경을 허용한다. `Shift+Tab`은 Ask, Auto-Review, Full Access 중 하나를 고르게 하며, 승인 설정이 언제 검토가 필요한지 정한다. 세션은 저장되고 `/goal`로 지속 목표를 지정하며, `/undo`와 `/restore`가 작업 공간 변경을 되돌린다. MCP 서버와 스킬을 연결하고 훅을 구성하며, 에이전트 역할은 프로젝트나 개인 설정의 파일로 둔다. Computer Use 플러그인은 다른 애플리케이션을 관찰·조작하는 도구를 추가한다.

무엇과 다른가

특정 모델 제공자에 묶이지 않는다. 호스티드 제공자와 함께 Ollama, vLLM, SGLang으로 띄운 로컬 모델을 붙일 수 있다. 원래 이름은 `deepseek-tui`였고 그 설정과 세션 호환성을 유지하며, 어떤 모델 제공자와도 제휴 관계가 없다. 권한은 승인 모드와 저장소 규칙, 선택적 OS 샌드박스가 겹쳐 적용되고 그 적용 순서는 별도 문서로 정의된다. 모델 가격을 알 수 없으면 무료로 보고하지 않고 미상으로 남긴다.

어떻게 쓰나

macOS와 Linux에서는 공식 GitHub 릴리스 설치 프로그램을 쓰고, Windows에서는 설치 프로그램이나 압축 파일을 내려받는다. 이미 직접 설치한 경우 `codewhale update`가 실행 파일 경로를 출력하며 더 새 빌드를 유지하고, `codewhale update --check`로 확인만 할 수 있다. 첫 실행에서 제공자를 연결하거나 오프라인 설정을 마친다. 프로젝트 폴더에서 `codewhale`을 실행하면 TUI가 열리고, `codewhale exec`는 스크립트나 CI 작업에서 한 번에 실행하며, `codewhale web`은 같은 런타임에 붙는 로컬 웹 클라이언트를 연다. 셸 자동 완성은 `codewhale completion bash|zsh|fish|powershell|elvish` 한 줄로 설치한다. npm과 Cargo가 보조 패키징 경로로 있고 Docker, Nix, Scoop, Android/Termux, CNB 미러도 있다.

전제와 한계

모델 응답에는 연결된 호스티드 또는 로컬 모델이 필요하다. Computer Use는 요청하는 접근 권한을 검토하고 켜야 하며 OS 권한과 플랫폼 요구 사항이 그대로 적용된다. 웹과 데스크톱 앱은 개발 중이다. Full Access도 정책 경계는 넘지 못하고, OS 샌드박스는 해당 기능을 갖춘 플랫폼에서만 동작한다. 라이선스는 MIT이고 다른 오픈소스에서 가져온 부분은 서드파티 고지에 기록된다.

관련 논문 3

유사 도구