O Agente de Código do Terminal que Te Coloca no Comando
<think> The user wants me to rewrite this blog post about cwcode from scratch in Portuguese. I need to:
- NOT translate literally - rewrite in my own words
- NOT copy sentence structure
- Keep the markdown format
- Write naturally as a Brazilian/Portuguese tech blogger
- Keep English technical terms (domain, hosting, SSL, DNS, VPS, etc.)
- Use short, clear sentences
- Make it sound like it was originally written in Portuguese
Let me go through the main ideas and rewrite them:
Introduction: Most AI coding tools are cloud-based, collect data, expensive, or questionable. cwcode is different - runs locally, terminal-based, built in Go.
Hash-Anchored Edits: Smart way to handle file edits using content hashes instead of requiring exact text reproduction. Saves tokens.
Sticky Prefix Cache: Uses DeepSeek's prompt cache - 120x cheaper on hits, 85%+ hit ratio after turn 3.
Plan vs Code Mode: Toggle with Shift+Tab to restrict to non-mutating tools for planning, then switch to execution mode.
Checkpoint & Rewind: Content-addressed snapshots before file changes, can rewind if something goes wrong.
Storm-Breaker: When a tool fails 3 times, synthesizes a clear explanation instead of looping.
Autonomous Goal Loop: /goal command with autonomous mode, up to 20 cycles, can run overnight.
Tool Registry: Comprehensive tools including bash, file operations, web fetch, sub-agents, memory, todos.
Why Go? Why Terminal?: Single binary, fast startup, no dependencies, cross-compilation easy.
Conclusion: Philosophy shift - privacy-respecting, cost-effective, local-first.
Let me write this naturally in Portuguese: </think>
Quando Seu Agente de IA Realmente Vive na Sua Máquina
Vamos ser sinceros: a maioria das ferramentas de IA para código hoje são produtos SaaS baseados na web que coletam seus dados de sessão, soluções enterprise caríssimas, ou extensões de navegador com práticas de privacidade questionáveis. É um espaço lotado, e a maioria das ofertas parece suspeitosamente similar.
Até que aparece o cwcode—um agente de codificação via terminal que pega um caminho radicalmente diferente. Construído inteiramente em Go (~12.000 linhas, sem serviços externos), essa ferramenta TUI conversa com qualquer endpoint OpenAI-compatible como um agente de codificação com ferramentas. Ela vem com perfis para DeepSeek V4 Pro, Qwen3.6-27B, Azure OpenAI, Kimi for Coding, e até um perfil vLLM local para rodar no seu próprio hardware.
O melhor? Sua chave de API fica em ~/.cwcode/config.json. Suas sessões ficam em ~/.cwcode/sessions/. Sem contas. Sem telemetria. Sem painel de controle remoto. Se sua rede cair e seu endpoint de modelo for local, o agente continua funcionando. Esse é o tipo de soberania que desenvolvedores realmente se importam.
Edits com Âncora de Hash: Uma Inovação Pensada em Desenvolvedores
Aqui é onde o cwcode mostra sua inteligência. A ferramenta read_file anota cada linha com um hash de 3 caracteres baseado no conteúdo. Quando você quer editar, a ferramenta edit_lines recebe (linha, hash, novo_texto) e rejeita toda a operação se qualquer hash divergiu. O modelo nunca precisa reproduzir conteúdo caractere-por-caractere para fazer uma edição.
Esse mecanismo aparentemente simples entrega resultados reais: tokens de saída por sessão caíram 30–40% no DeepSeek V4 Pro. Menos geração de tokens significa respostas mais rápidas e custos menores. É o tipo de otimização que só vem de alguém que usa a ferramenta todos os dias.
Cache de Prefixo Persistente: O Otimizador de Custos Que Você Não Sabia Que Precisava
O caminho de cache de prompts do DeepSeek é aproximadamente 120× mais barato que o caminho de miss. O cwcode faz isso funcionar de forma confiável através de engenharia cuidadosa: o system prompt é byte-estável entre turnos, definições de ferramentas serializam em ordem determinística, e conteúdo de raciocínio é removido das requisições outbound por padrão em todo provider.
O resultado? Um comando /cache que mostra sua taxa de acerto cumulativa da sessão, que rotineiramente ultrapassa 85% após o terceiro turno. Depois disso, você basicamente roda a uma fração do custo. Para desenvolvedores внимательны aos gastos com API, isso é significativo.
Modo Plan vs. Code: Colocando Humanos de Volta no Controle
Toda ferramenta de IA para código diz ser "amigável para desenvolvedores", mas poucas respeitam realmente o fluxo de trabalho do desenvolvedor. O modo Plan do cwcode é um único toggle com Shift+Tab que restringe o LLM a apenas ferramentas não-mutadoras. O modelo não vê uma flag—ele simplesmente vê um registro de ferramentas diferente e menor, com um addendum no system prompt explicando que está em modo planejamento.
Isso significa que você pode perguntar "o que você mudaria?" sem executar nada por acidente. Quando estiver pronto, mude para o modo Code e solte o bicho. Você mantém o controle final a menos que explicitamente opte pelo modo YOLO para operação autônoma.
Checkpoint & Rewind: Exploração Segura Sem a Ansiedade
Todos já passamos por isso: você deixa um agente de IA modificar um arquivo, algo dá errado, e agora seu codebase está em um estado inconsistente. O cwcode resolve isso com snapshots com endereçamento por conteúdo.
Antes de qualquer ferramenta que muta arquivos rodar, o harness faz snapshot do estado pré de cada path que aquela ferramenta declarou que vai tocar. Os snapshots são blobs-chaveados por SHA-256 em ~/.cwcode/sessions/<id>/objects/, automaticamente deduplicados. Se algo der errado, /rewind N restaura arquivos, trunca o histórico da conversa, e pré-preenche a caixa de input com seu prompt original. É como Git, mas embutido no próprio agente.
Storm-Breaker: Quando Falhas Ficam Honestas
Quando a mesma ferramenta falha idênticamente três vezes seguidas, a maioria dos agentes ou faz loop para sempre ou aborta silenciosamente. O sistema Storm-breaker do cwcode sintetiza uma explicação em linguagem simples ("Não consigo continuar: read_file falhou três vezes porque o path estava vazio. Por favor, clarifique..."), transmite como uma resposta normal, e appenda ao histórico para que follow-ups tenham contexto.
Isso transforma becos sem saída frustrantes em feedback acionável. Você sabe exatamente o que deu errado e por quê, sem fuçar logs ou debugar a ferramenta sozinho.
O Loop Autônomo de Goals: Deixe Rodar a Noite Toda
O comando /goal <texto> appenda objetivos a goals.md. Mas /goal on eleva isso a outro nível—inicia um loop autônomo que roda turnos atrás-de-trás até que cada checkbox esteja marcada como done ou até um limite de segurança de 20 ciclos consecutivos. Equipes estão reportando sessões de quatro horas durante a noite em tarefas anotadas.
Não se trata de deixar o agente rodar solto. É sobre batchar trabalho durante horários de folga, voltando na manhã seguinte para um codebase completo. Para startups com bandwidth de engenharia limitado, isso é um multiplicador de produtividade genuíno.
O Registro de Ferramentas: Tudo Que Você Precisa, Nada Que Você Não Precisa
O cwcode vem com um conjunto completo de ferramentas que cobre fluxos de trabalho reais de desenvolvimento: bash com output streaming, bash_background para processos longos, read_file com hashes por linha, write_file para criação e sobrescrita, edit_file com substituição exata de string, edit_lines para mudanças com âncora de hash, glob para pattern matching, grep para buscas regex, ls para listagem de diretórios, web_fetch para retrieval de URLs, chrome_fetch para páginas bloqueadas por bots (direcionadas via CDP pelo seu browser real), task para spawnar sub-agentes com contexto isolado, remember e recall para memória semântica persistente, e todo_write para tracking visível de tarefas.
Adicionar uma nova ferramenta é uma interface Go de dois métodos—600 linhas de código de registry, e sua nova ferramenta está no ar. A arquitetura torna extensibilidade Indolore.
Por Que Go? Por Que o Terminal?
Binário estático único, startup em sub-segundos, cross-compilation trivial. O time shipa três builds de plataforma em 90 segundos. O binário TUI do macOS tem 24 MB com símbolos de debug stripados. Sem dependências runtime, sem Node.js necessário, sem dores de cabeça de npm install.
Quanto a por que um app de terminal ao invés de uma extensão de VS Code? O time queria que o agente fosse a interface principal, não um painel lateral. O TUI dá ao modelo a janela inteira para trabalhar e dá uma superfície pequena para debugar. Se você vive no VS Code, pode rodar cwcode no terminal integrado. A escolha é sua.
O Veredicto Final
O cwcode representa uma mudança de filosofia: agentes de IA para código não precisam ser produtos SaaS hospedados na nuvem que monetizam sua atenção e dados. Você pode ter um assistente de codificação poderoso e econômico que respeita sua privacidade, roda localmente, e não fica no seu caminho.
A aproximadamente 5% do custo de tokens do Claude usando DeepSeek V4 Pro, com uma taxa de acerto de prefix-cache de 85%+ após o turno três, e zero dependências externas, o cwcode não é apenas uma conquista técnica—é uma declaração de que desenvolvedores merecem ferramentas melhores.
O projeto vive inteiramente sob ~/.cwcode/, usa JSON para config, SQLite para memória, e blobs com endereçamento por conteúdo para checkpoints. Se o projeto desaparecesse amanhã, suas sessões ainda seriam legíveis. Esse é o tipo de longevidade e portabilidade que importa em ambientes de produção.
Se você está procurando um agente de codificação que prioriza seu controle, seus dados, e sua carteira, o cwcode merece uma olhada mais de perto.