Codewhale
GitHub
CodewhaleMIT

데이터와 코드의 바다

깊은 바다로 잠수하고,
당신은 잠수하지 않아도 됩니다.

Codewhale은 평범한 사람들에게 LLM의 지렛대를 건네줍니다. 터미널에서 저장소를 읽고, 파일을 수정하고, 검사를 실행하고, 기록을 남깁니다 — 코드를 이미 알 필요는 없습니다. 당신의 머신에서 실행됩니다.

설치문서GitHub
npm install -g codewhale

최신 릴리스 v0.9.2 · 현재 소스 v0.9.2: 프로바이더 라우트 36개 · MIT

Codewhale TUICurrent session
Current Codewhale terminal session showing Operate mode, the whale, composer, and footer
Current Codewhale session · Operate mode · Ask permission posture

수중 터미널 셸. 모델 중립. 로컬 우선.

이미 사용 중인 호스티드, 게이트웨이 또는 로컬 모델을 그대로 사용하세요. Codewhale은 당신의 머신에서 실행되며 모델을 제품이 아닌 선택 가능한 구성 요소로 취급합니다. Plan / Act / Operate와 명시적 권한 상태로 깊은 잠수도 통제할 수 있습니다.

작업에서 검증된 변경까지.

  1. 01

    검사

    저장소, 지침, 작업을 읽습니다.

  2. 02

    실행

    명시적 승인 경계 안에서 파일을 수정합니다.

  3. 03

    검증

    검사를 실행하고 결과를 확인합니다.

  4. 04

    보고

    간결하고 지속 가능한 기록을 남깁니다.

$ codewhale exec "fix the failing test"inspect   repository and instructionsact       edit through the selected permission postureverify    cargo test --lockedreport    checks passed · receipt saved

New to Codewhale? Four steps end to end.

Install → a first keyless session → provider connection → a first Fleet workflow. The nouns are defined on the vocabulary page.

  1. Install Codewhale

    One npm command installs the dispatcher and the terminal runtime. Cargo, prebuilt archives, Docker, Nix, and China mirrors are documented alternatives; every channel serves published releases only.

    npm install -g codewhale
codewhale doctor
    Full install guide →

  2. Open a first session — no key needed

    The runtime launches without any API key: a short constitution-first setup (language, provider readiness, runtime posture, your constitution), then the full interface. Explore in Plan mode — it is always read-only. Model replies need a provider; that is the next step.

    codewhale
    Learn the product nouns first →

  3. Connect a provider

    Pick any supported route — a hosted key, a gateway, or a keyless local runtime such as Ollama, vLLM, or SGLang for fully local inference. Provider and model stay explicit; requested and effective reasoning plus routing source are separate provenance fields, and unavailable values stay unavailable.

    codewhale auth set --provider deepseek
    Providers and models →

  4. Run a first Fleet workflow

    When work needs durable workers, ordered phases, or receipts, author a reusable agent-team profile and launch a run. Fleet state lives in the workspace ledger and survives restarts; ordinary single tasks need none of this.

    codewhale fleet init
codewhale fleet run tasks.json --max-workers 4
    Fleet and Workflow docs →
Read the getting-started guide →See the product vocabulary →

당신의 모델.
당신의 경계.

모델, 작업 모드, 권한 상태를 명시적으로 선택하세요. 알 수 없는 비용은 알 수 없는 상태로 유지하고, 미리보기 기능은 그렇게 표시합니다.

프로바이더 라우트 36개
호스티드, 게이트웨이, 로컬 모델
Plan · Act · Operate
읽기 전용 계획부터 자율 실행까지
Ask · Auto-Review · Full Access
작업에 맞는 권한 상태 선택
TUI · exec · web · API
대화형 및 헤드리스 런타임 화면

작업이 일어나는 곳에서 런타임을 사용하세요.

TUI대화형 터미널 작업
codewhale exec스크립트와 CI
웹 클라이언트루프백 전용 브라우저 클라이언트
Runtime API + MCP로컬 통합
Fleet지속적인 멀티 에이전트 작업
런타임 화면과 안정성 노트 보기 →

하나의 명령으로 시작하세요.

npm install -g codewhale

Cargo · 바이너리 · Docker · Nix · Windows · Android / Termux · 중국 미러

설치 가이드 읽기 →

공개적으로 개발

MIT 라이선스이며 런타임, 프로바이더, 플랫폼, 문서, 테스트 전반의 기여자들이 함께 만들어 갑니다.