Hmbown/Codewhale

Codewhale

Codewhale는 Rust로 구축되고 사용자들과 함께 공개적으로 개선되는 터미널용 오픈소스 코딩 에이전트입니다.

설치

npm install -g codewhale
codewhale

첫 실행 시 제공자(provider) 연결 또는 오프라인 유지 옵션을 안내합니다. Codewhale은 Cargo, Docker, Nix, Scoop, 사전 빌드된 아카이브, Android/Termux, CNB 미러도 지원합니다. 설치 가이드를 참조하세요.

탭 완성은 셸별로 한 번의 명령으로 설정됩니다 — codewhale completion bash|zsh|fish|powershell|elvish. 셸 완성 문서를 참조하세요.

사용법

팀원에게 말하듯이 Codewhale과 대화하세요:

실패하는 테스트를 고치고 무엇이 변경되었는지 설명해줘.

또는 TUI를 열지 않고 작업을 실행하려면:

codewhale exec "실패하는 테스트를 고치고 무엇이 변경되었는지 설명해줘"

Codewhale은 저장소를 읽고, 파일을 편집하고, 명령을 실행하고, 결과를 검사하며, 목표를 향해 계속 작업할 수 있습니다. 에이전트에 부여할 접근 수준은 사용자가 결정합니다.

Codewhale을 선택하는 이유

• 원하는 모델을 사용하세요. 호스팅 제공자 또는 Ollama, vLLM, SGLang을 통한 로컬 모델에 연결하세요. /model로 제공자와 모델을 전환하세요.
• 통제권을 유지하세요. Plan은 읽기 전용입니다. Ask, Auto-Review, Full Access 모드는 승인 동작을 명확히 보여줍니다. /undo는 마지막 턴을 되돌리고 /restore는 작업 공간을 이전 스냅샷으로 복원합니다.
• 긴 작업을 체계적으로 유지하세요. 세션을 저장하고, 지속적인 /goal을 설정하고, 실행 전에 워크플로우를 검토하고, 에이전트의 내부 지시사항을 대화 기록에 노출하지 않고 에이전트를 조정하세요.
• 기존 에이전트를 확장하세요. MCP 서버와 스킬을 연결하고, 훅을 구성하고, 에이전트 역할을 프로젝트 또는 개인 설정의 읽기 가능한 파일로 유지하세요.

TUI에서 /help를 실행하면 명령과 키보드 단축키를 확인할 수 있습니다.

안전

Codewhale은 사용자가 부여한 접근 권한으로 사용자 머신에서 실행됩니다. 승인 모드와 저장소 규칙은 에이전트가 수행할 수 있는 작업을 제한하며, 선택적 OS 샌드박싱은 지원되는 환경에서 더 강력한 실행 경계를 추가합니다. 알 수 없는 모델 가격은 무료로 표시되지 않고 알 수 없음으로 유지됩니다.

정확한 정책 스택은 권한 부여 순서 문서를, 로컬 설정 구성은 설정 문서를 읽으세요.

문서

• 제공자 및 로컬 모델
• 에이전트 팀
• MCP, 훅 및 구성
• 로컬 웹 클라이언트
• 전체 문서

커뮤니티 참여

Codewhale은 사람들이 사용하고, 문제점을 보고하고, 수정을 도울 때 더 좋아집니다. 제공자가 누락되었거나, 워크플로우가 어색하거나, 터미널 UI가 불편하다면 이슈를 열어주세요. 개선 방법을 안다면 풀 리퀘스트를 열어주세요. 첫 기여도 환영하며, 기여자는 반영된 작업에 대한 크레딧을 유지합니다.

Discord에 참여하거나 WeChat(hunterbown)에서 Hunter를 추가하고 Whale Brothers 그룹 가입을 요청하세요.

프로젝트 역사

Codewhale은 deepseek-tui로 시작했으며 여전히 해당 구성 및 세션 호환성을 유지합니다. 현재는 제공자 중립적이며 독립적으로 유지보수됩니다. 어떤 모델 제공자와도 제휴하지 않습니다.

프로젝트 성장을 도운 모든 기여자와 오픈소스 커뮤니티에 감사드립니다. 기여자 기록을 참조하세요.

---

평가

strengths

• Rust 기반으로 빠르고 안정적인 터미널 코딩 에이전트를 제공하며, 다양한 설치 방법(npm, Cargo, Docker, Nix 등)을 지원합니다.
• Plan/Ask/Auto-Review/Full Access 등 명확한 승인 모드와 /undo, /restore 같은 안전 장치를 갖추어 사용자 통제권을 강조합니다.
• MCP, 훅, 스킬, 에이전트 팀 등 확장성이 뛰어나며, 로컬 모델(Ollama, vLLM, SGLang)과 호스팅 제공자를 모두 지원합니다.
• 오픈소스 커뮤니티 중심 개발(이슈/PR 환영)과 활발한 기여 문화를 보여줍니다.

weaknesses

• README에서 구체적인 설정 파일 형식이나 고급 구성 예시가 부족하여, 처음 사용자가 심화 기능을 바로 활용하기 어려울 수 있습니다.
• OS 샌드박싱이 '지원되는 환경'에서만 가능하다고 명시되어 있어, 모든 플랫폼에서 동일한 보안 수준을 기대하기 어렵습니다.
• 프로젝트가 deepseek-tui에서 전환된 이력이 있어, 일부 사용자에게는 제공자 중립성에 대한 신뢰 검증이 필요할 수 있습니다.

cautions

• 에이전트에 부여하는 접근 권한 수준을 신중히 설정해야 하며, 특히 Full Access 모드에서는 코드 실행 및 파일 변경이 자동으로 이루어질 수 있습니다.
• 알 수 없는 모델 가격은 '알 수 없음'으로 표시되므로, 비용 추정이 필요한 환경에서는 사전에 제공자 가격을 확인하는 것이 좋습니다.
• /undo와 /restore 기능이 있지만, 중요한 작업 전에는 별도 백업이나 버전 관리 사용을 권장합니다.

fitforjason

• 터미널 기반 AI 코딩 에이전트를 찾는 개발자에게 적합하며, 특히 로컬 모델과의 통합, MCP 확장, 세밀한 승인 제어가 필요한 프로젝트에 유용합니다.
• 오픈소스로 활발히 개선 중이고 MIT 라이선스이므로, 개인 워크플로우에 맞춰 커스터마이징하거나 기여할 가치가 있습니다.

install_difficulty

"low"

next_actions

• npm을 통해 Codewhale을 설치하고 첫 실행 시 제공자 연결 또는 오프라인 모드를 설정해 보세요.
• /help 명령으로 TUI의 주요 명령과 단축키를 숙지하고, 간단한 작업부터 codewhale exec로 테스트해 보세요.
• MCP 서버 연결, 훅 구성, 에이전트 팀 설정 등 고급 기능을 문서에서 확인하고 프로젝트에 적용해 보세요.
• 이슈나 PR을 통해 발견한 문제점이나 개선 아이디어를 커뮤니티에 공유해 보세요.