Codewhale
러스트로 만든 터미널 코딩 에이전트
curl -fsSL https://codewhale.net/install.sh | sh터미널에서 도는 오픈소스 코딩 에이전트입니다. 저장소를 읽고 파일을 고치고 명령을 돌려 결과를 보면서 목표를 향해 계속 작업합니다. 권한을 네 단계로 나눠 두어 계획 모드는 읽기만 하고, 물어보기와 자동 검토, 전체 허용 중에서 승인 방식을 고릅니다. 되돌리기 명령이 마지막 턴을 취소하고 복원 명령이 작업 공간을 이전 스냅숏으로 돌립니다. 호스팅 제공자뿐 아니라 Ollama, vLLM, SGLang 으로 로컬 모델을 붙일 수 있고 모델 전환은 명령 하나입니다. MCP 서버와 스킬, 훅을 붙이고 에이전트 역할은 프로젝트 안의 읽을 수 있는 파일로 둡니다.
판단
이럴 때 씁니다
- 터미널에서 도는 코딩 에이전트를 러스트 단일 바이너리로 쓰고 싶을 때
- 권한 단계를 눈에 보이게 나눠 두고 승인 방식을 고르고 싶을 때
- 로컬 모델과 호스팅 제공자를 오가며 써야 할 때
이럴 땐 쓰지 마세요
- 편집기 통합이 먼저면 IDE 확장 쪽이 낫습니다
- 팀 공유 설정과 중앙 정책이 필요하면 아직 개인 도구에 가깝습니다
- 특정 제공자에 고정해 쓸 계획이면 제공자 중립 설계의 이점이 적습니다
차별점
- 계획 모드가 읽기 전용이라 승인 없이 파일이 바뀌지 않습니다.
- Ollama, vLLM, SGLang 으로 로컬 모델을 그대로 붙입니다.
- 에이전트 역할을 프로젝트 안의 읽을 수 있는 파일로 둡니다.
워크플로
- 01설치 스크립트로 바이너리를 받습니다.
- 02첫 실행에서 제공자를 연결하거나 오프라인으로 둡니다.
- 03TUI 에서 대화하거나 exec 로 한 줄 작업을 시킵니다.
- 04권한 단계를 골라 어디까지 자동으로 진행할지 정합니다.
- 05되돌리기와 복원으로 마지막 턴이나 이전 스냅숏으로 돌아갑니다.
주요 명령
| 명령 | 설명 |
|---|---|
curl -fsSL https://codewhale.net/install.sh | sh | 바이너리를 설치합니다. |
codewhale exec "fix the failing tests" | TUI 를 열지 않고 한 줄 작업을 시킵니다. |
codewhale update --check | 설치본을 점검하고 갱신합니다. |
/undo | 마지막 턴을 되돌립니다. |
/restore | 작업 공간을 이전 스냅숏으로 돌립니다. |
함정
설치 전에 확인하세요
- 예전 이름인 deepseek-tui npm 패키지는 더 이상 릴리스가 나오지 않습니다. v0.8.x 계열 이름을 쓰고 있었다면 옮겨야 합니다.
- 에이전트가 내 기계에서 내가 준 권한만큼 돕니다. OS 샌드박스는 지원되는 환경에서만 추가 경계를 줍니다.
- 가격을 모르는 모델은 무료라고 표시하지 않고 모른다고 둡니다. 비용 계산을 이 값에 의존하면 안 됩니다.
비교
터미널 코딩 에이전트는 대체로 특정 제공자에 맞춰 시작합니다. 이쪽은 처음부터 제공자 중립으로 두고 권한 단계와 되돌리기를 앞세웁니다. 그만큼 특정 모델에 최적화된 동작은 적고, 어디까지 허용할지를 직접 정하는 성격이 강합니다.
최근 변경
Shannon Labs 의 공개 제품으로 정리되면서 명령과 npm 패키지, 릴리스 자산 이름을 codewhale 로 통일했습니다. 예전 deepseek-tui 패키지는 폐기됐고 v0.8.x 계열 이름을 쓰던 사용자는 이전 안내를 받습니다. 설정과 세션 호환성은 유지됩니다.