wehub-resource-sync
117 lines
5.9 KiB
Markdown
117 lines
5.9 KiB
Markdown
<!-- source: README.md sha256:561a074b0e36 -->
|
|
# CodeWhale
|
|
|
|
Um agente de código para o seu terminal. Funciona com qualquer modelo; modelos
|
|
abertos em primeiro lugar.
|
|
|
|
Você informa um provedor, um modelo e uma tarefa. Ele lê código, edita
|
|
arquivos, executa comandos, verifica os resultados e continua até a tarefa
|
|
terminar ou até precisar de você. TUI para trabalho interativo,
|
|
`codewhale exec` para scripts e CI. Rust, MIT, roda inteiramente na sua
|
|
máquina.
|
|
|
|
Começou como `deepseek-tui`. A comunidade que se formou em volta dele
|
|
precisava de mais provedores, então hoje DeepSeek, Claude, GPT, Kimi, GLM e
|
|
mais de 30 outros rodam pelo mesmo runtime e pelas mesmas ferramentas.
|
|
|
|
[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [codewhale.net](https://codewhale.net/) · [Docs](docs) · [Changelog](CHANGELOG.md)
|
|
|
|
[](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml)
|
|
[](https://crates.io/crates/codewhale-cli)
|
|
[](https://www.npmjs.com/package/codewhale)
|
|
|
|
|
|
|
|
## Instalação
|
|
|
|
```bash
|
|
npm install -g codewhale
|
|
```
|
|
|
|
Cargo, Docker, Nix, Scoop, arquivos pré-compilados, Android/Termux e um
|
|
espelho CNB para quem não consegue acessar o GitHub estão cobertos em
|
|
[docs/INSTALL.md](docs/INSTALL.md). Vindo do `deepseek-tui`? Sua configuração
|
|
e suas sessões são preservadas — veja [docs/REBRAND.md](docs/REBRAND.md).
|
|
|
|
## Uso
|
|
|
|
```bash
|
|
codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc.
|
|
codewhale # open the TUI
|
|
codewhale exec "fix the failing test" # headless
|
|
```
|
|
|
|
Na TUI: `/model` troca provedor e modelo juntos, `/fleet` executa uma equipe
|
|
de workers, `/restore` desfaz um turno, `Tab` cicla entre Plan / Act / Operate,
|
|
`Shift+Tab` cicla a postura de permissão Ask / Auto-Review / Full Access, e
|
|
`!` executa um comando de shell pelo caminho normal de aprovação.
|
|
|
|
## O que ele faz
|
|
|
|
- Resolve sua escolha de provedor + modelo em uma rota concreta: endpoint,
|
|
protocolo de comunicação, limite de contexto, preço. Orçamentos de contexto
|
|
e a exibição de custo vêm da rota real; um preço desconhecido aparece como
|
|
desconhecido, não como $0.
|
|
([docs/PROVIDERS.md](docs/PROVIDERS.md))
|
|
- Conversa com provedores hospedados de modelos abertos (`deepseek`,
|
|
`openrouter`, `moonshot`, `zai`, `minimax`, `nvidia-nim`, …), com seu
|
|
próprio `vllm` / `sglang` / `ollama` sem chave, e com a Anthropic
|
|
nativamente pela Messages API, com thinking e cache de prompt.
|
|
- Executa vários workers de forma durável: o Fleet registra o trabalho em um
|
|
ledger append-only, então as execuções sobrevivem a reinícios e
|
|
`fleet resume` retoma de onde as coisas pararam. O Workflow planeja
|
|
trabalhos maiores em trilhas retomáveis e verificáveis.
|
|
([docs/FLEET.md](docs/FLEET.md))
|
|
- Controla risco em código, não em achismo: três modos (Plan é somente
|
|
leitura), uma postura de permissão separada, sandbox do sistema operacional
|
|
(Seatbelt, Landlock + seccomp, bwrap), hooks que podem
|
|
permitir/negar/perguntar a cada chamada de ferramenta, e snapshots em um git
|
|
paralelo para que `/restore` nunca toque no seu histórico real.
|
|
- Permite que um repositório declare sua própria lei: os invariantes de
|
|
`.codewhale/constitution.json` compilam em bloqueios de escrita que nem o
|
|
Full Access consegue pular.
|
|
([docs/CONFIGURATION.md](docs/CONFIGURATION.md))
|
|
- Fala MCP nas duas direções, carrega skills reutilizáveis, expõe APIs de
|
|
runtime HTTP/SSE e ACP, e dá suporte a uma
|
|
[GUI para VS Code](https://github.com/HengQuWorld/CodeWhale-VSCode) da
|
|
comunidade.
|
|
- A TUI mostra o trabalho como recibos que você pode inspecionar, mantém uma
|
|
única linha ao vivo em movimento, tem um inspetor de contexto de verdade,
|
|
12 temas, modos de movimento reduzido e ASCII seguro, e é distribuída em
|
|
English, 简体中文, 日本語, Tiếng Việt, Español, Português, 한국어 e 繁體中文
|
|
parcial.
|
|
|
|
Todo o resto — configuração, atalhos de teclado, detalhes do sandbox,
|
|
arquitetura — está em [docs](docs) e em [codewhale.net](https://codewhale.net/).
|
|
|
|
## Contribuindo
|
|
|
|
Todo feedback é um presente. Issues, PRs, passos de reprodução, logs, pedidos
|
|
de funcionalidade e primeiras contribuições — tudo isso é trabalho real do
|
|
projeto aqui. Quando um PR não pode ser mesclado como está, os mantenedores
|
|
aproveitam o que funciona e o autor continua creditado — no commit, no
|
|
changelog e em [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md). Se um modelo ou
|
|
provedor que você usa está faltando, ou se algo quebra na sua máquina, nos
|
|
contar é a coisa mais útil que você pode fazer.
|
|
|
|
- [Issues abertas](https://github.com/Hmbown/CodeWhale/issues) — boas
|
|
primeiras contribuições moram aqui
|
|
- [CONTRIBUTING.md](CONTRIBUTING.md) — setup de desenvolvimento e fluxo de PR
|
|
- [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — todo mundo que ajudou a
|
|
moldar o projeto
|
|
- [Me pague um café](https://www.buymeacoffee.com/hmbown)
|
|
|
|
Obrigado à [DeepSeek](https://github.com/deepseek-ai) pelos modelos e pelo
|
|
apoio que deram início ao projeto, à
|
|
[DataWhale](https://github.com/datawhalechina) 🐋 por nos receber na família
|
|
Whale Brother, e a [OpenWarp](https://github.com/zerx-lab/warp) e
|
|
[Open Design](https://github.com/nexu-io/open-design) pela colaboração na
|
|
experiência de agente no terminal.
|
|
|
|
## Licença
|
|
|
|
[MIT](LICENSE). Projeto comunitário independente; sem afiliação com nenhum
|
|
provedor de modelos.
|
|
|
|
[](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date)
|