Repolode
tolimarchuk

tolimarchuk/goalbuddy

Um workspace local para executar metas que oferece ao Codex e ao Claude Code um charter, quadro de tarefas, registros e um ciclo de verificação para tarefas longas de programação.

Estrelas
824
Forks
66
Issues abertas
10
Último commit
mês passado

O que é?

O GoalBuddy ajuda o Codex e o Claude Code a manter o foco durante tarefas longas de programação. Ele cria um workspace compacto dentro do seu repo, com um charter da meta, um arquivo de estado que acompanha o quadro, anotações e registros de cada tarefa concluída. Assim, uma execução pode ser pausada, retomada e ter seu progresso verificado sem precisar refazer o planejamento a cada turno.

Uma meta passa por um ciclo fixo: um scout mapeia o repo, um judge escolhe a maior parte útil e segura do trabalho, um worker a conclui e deixa um registro, e um judge faz uma auditoria final dos registros em relação ao sinal de verificação acordado. Um quadro local e atualizado em tempo real mostra o plano, a tarefa ativa, as submetas e o status da verificação enquanto o trabalho está em andamento.

Como os quadros são arquivos simples, uma meta iniciada em um harness pode ser retomada no outro usando `npx goalbuddy resume`. A CLI também inclui `dispatch`, que executa uma tarefa em modo headless na CLI de outro fornecedor, com verificações de escopo de escrita baseadas em git, além dos comandos `doctor`, `update` e `reset` para gerenciar a instalação.

Recursos principais

  • 01Cria um charter da meta, um arquivo de estado e uma pasta de anotações dentro do repo
  • 02O quadro local e atualizado em tempo real mostra o plano, a tarefa ativa, os registros e as submetas
  • 03Funciona com Codex e Claude Code e permite retomar um quadro em qualquer um dos ambientes
  • 04`dispatch` executa uma tarefa em modo headless em outra CLI e verifica o escopo de escrita usando git
  • 05As submetas permitem que uma tarefa principal tenha um quadro filho com escopo delimitado

Casos de uso

  • Realizar uma melhoria ampla no projeto, distribuída por vários arquivos, com verificação a cada etapa
  • Preparar uma release com verificações registradas como comprovantes
  • Investigar bugs que exigem evidências antes da aprovação de uma correção
  • Fazer refactors que precisam passar nos testes em marcos definidos

Início rápido

  1. 1

    Execute a configuração com um único comando

    npx goalbuddy
  2. 2

    Reinicie o Codex ou o Claude Code

  3. 3

    Prepare uma meta no Codex com a skill goal-prep

    $goal-prep
  4. 4

    Execute o comando exibido do Codex /goal ou do Claude Code /goalbuddy para executar o quadro

Antes de usar

  • O Codex /goal nativo é um recurso cujo acesso é controlado pela OpenAI; o GoalBuddy não o habilita nem o substitui.
  • É necessário instalar e usar o Codex ou o Claude Code como ambiente do agente.

Em coleções

Tópicos

Perguntas frequentes

O que é goalbuddy?
Um workspace local para executar metas que oferece ao Codex e ao Claude Code um charter, quadro de tarefas, registros e um ciclo de verificação para tarefas longas de programação. O GoalBuddy ajuda o Codex e o Claude Code a manter o foco durante tarefas longas de programação. Ele cria um workspace compacto dentro do seu repo, com um charter da meta, um arquivo de estado que acompanha o quadro, anotações e registros de cada tarefa concluída. Assim, uma execução pode ser pausada, retomada e ter seu progresso verificado sem precisar refazer o planejamento a cada turno.
goalbuddy é gratuito? Qual é a licença?
goalbuddy é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
goalbuddy ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de goalbuddy foi em 2 de out. de 2026.
Para que posso usar goalbuddy?
Realizar uma melhoria ampla no projeto, distribuída por vários arquivos, com verificação a cada etapa Preparar uma release com verificações registradas como comprovantes Investigar bugs que exigem evidências antes da aprovação de uma correção Fazer refactors que precisam passar nos testes em marcos definidos
Como instalar goalbuddy?
Execute a configuração com um único comando: npx goalbuddy Reinicie o Codex ou o Claude Code Prepare uma meta no Codex com a skill goal-prep: $goal-prep Execute o comando exibido do Codex /goal ou do Claude Code /goalbuddy para executar o quadro
Onde consigo goalbuddy?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tolimarchuk/goalbuddy

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados