Claude-Code

O usuário mais frequente do meu CLI não sou eu lql é um CLI em Rust para gerenciar issues do Linear. Escrevi porque nenhuma das alternativas existentes funcionava para meu caso de uso real: um agente de IA que gerencia issues de forma autônoma. Por que tive que escrever meu próprio CLI O MCP do Linear foi a primeira tentativa. A ideia é elegante: um servidor MCP que expõe a API do Linear diretamente ao agente. Na prática, era lento, instável, e o agente tinha que construir queries GraphQL do zero a cada chamada. Cada chamada era uma oportunidade de inventar um campo que não existe. Desinstalei em duas semanas. ...

Chega um momento na vida de todo programador com copilotos em que você olha a fatura mensal e pensa: “Tudo bem, mas tem mais assinatura aqui do que no meu plano da academia do bairro”. Esse momento chegou para mim com uma combinação bastante séria: Claude Max 5, Codex Plus e a tentação de experimentar Z.AI com OpenCode para os trabalhos mais baratos. A ideia parecia ótima. Mas o problema é outro: se você coloca três agentes no seu fluxo sem regras, acaba como aquele chefe de obra que tem todo mundo correndo de um lado para outro, mas ninguém segurando o projeto. ...

TL;DR: Se você está no Codex, use um command para controlar a sessão ou a aplicação, e use um skill para ensinar ao agente uma maneira de trabalhar. No Claude Code, a documentação atual já trata as skills como algo invocável com /skill-name, então os dois conceitos se misturam muito mais. No Codex, não: types pode existir como skill e /types ainda assim pode não existir. Existe uma confusão bastante comum quando você migra do Claude Code para o Codex. E isso é compreensível. ...

TL;DR: Depois de 165 sessões com Claude Code e 27 com Codex CLI, o padrão é claro: Claude para o trabalho interativo em que você precisa pensar em voz alta, Codex para tarefas autônomas que você delega e esquece. Não é sobre qual é melhor, mas sobre quando usar cada um. Meus dados mostram que a combinação é mais eficiente do que qualquer um isoladamente. São nove da manhã, café na mão, e eu tenho uma ideia ainda meio-formada sobre como reestruturar um módulo. Não sei exatamente o que quero. Só sei que o estado atual não me agrada. ...

TL;DR: Meu agente de IA tinha um arquivo de instruções com 246 linhas para gerenciar issues no Linear. Dentre elas, 150 eram gambiarras: UUIDs hardcoded, alternativas com curl, notas explicando “a CLI não suporta X”. Em vez de reescrevê-las, criei uma ferramenta que tornou essas linhas desnecessárias. Agora, essas 150 linhas se reduziram a zero. Você já escreveu um documento de instruções tão longo que a própria extensão dele é prova de que algo está errado? ...

Imagine que você pede a alguém para construir uma estante. A pessoa entrega algo bonito, com prateleiras, parafusos, tudo no lugar. Você encosta na parede e ela desaba. Os parafusos são cenográficos. Parecem parafusos, mas são de plástico. É isso que um LLM faz quando abusa do sistema de tipos. Ele te entrega código que compila, passa os testes, e parece correto. Porém, por dentro, onde deveriam haver tipos com significado, há strings. Onde deveria haver um estado explícito, há um nil que pode ter três significados diferentes, dependendo de quem lê. E onde deveria haver um enum com dois casos, há um == "claude" que alguém eventualmente escreverá errado, sem ninguém perceber até chegar em produção. ...

Você já escreveu um plano técnico às onze da noite, convencido de que estava impecável, e então descobriu pela manhã que esqueceu da autenticação? Eu já passei por isso. Mais de uma vez. E o pior não é o fato de esquecer — é que, quando você usa uma IA para planejar, o plano parece tão coerente que seu cérebro para de procurar falhas. Claude gera um documento com seções, dependências, ordem de execução, e tudo se encaixa. Parece um plano feito por um engenheiro sênior. Mas ninguém o contestou. ...

Imagine que você tem um colega de trabalho brilhante. Ele resolve problemas complexos, escreve código limpo, entende o que você pede de primeira. Mas toda manhã, quando você diz “abra o projeto do curso”, ele te encara com cara de dúvida e pergunta: “Que curso? Onde está?” Todos os dias. Sem exceção. É exatamente como conviver com Leonard Shelby, o protagonista de Memento. O cara que não consegue formar novas memórias e precisa tatuar as informações importantes no corpo para não esquecê-las. ...

Tenho três sessões do Claude Code abertas neste momento. Uma está traduzindo posts do blog. Outra está escrevendo testes para uma CLI. A terceira está me ajudando a depurar um pipeline de dados. Cada uma no seu próprio worktree, cada uma no seu próprio split do Ghostty, e eu alternando entre elas com Cmd+Alt+Setas. Não abro o iTerm2 há meses. Não mexo no tmux há semanas. Tudo vive em uma única janela do Ghostty. ...

Algumas semanas atrás, escrevi sobre git worktrees — o que são, como criá-los e por que são melhores do que clonar o repositório três vezes. O básico. Mas o básico é só metade da história. Porque o Claude Code não apenas funciona com worktrees — ele tem suporte nativo para eles. Flags dedicadas, isolamento automático, integração com tmux. E a diferença entre saber que worktrees existem e saber como o Claude Code os aproveita é como ter um carro e descobrir que ele tem modo esportivo. ...