Mod de branch do Git para Claude Code: branch e alterações acima do prompt

O mod de branch do Git para Claude Code coloca uma linha acima da caixa de entrada que diz onde você está no git: ⎇ main · 3 changed · ↑1 ↓0. Você vê o nome da branch, quantos caminhos o git status informa como alterados e quanto a branch está à frente e atrás do upstream. Quando o HEAD está destacado (detached), ele mostra o hash curto do commit no lugar. Fora de um repositório git, a linha simplesmente não aparece.

Ele ajuda principalmente quando o Claude está editando por você. Você percebe na hora se uma sessão começou na main em vez de uma branch de feature, e o contador de alterações sobe conforme o Claude edita, então você sabe quando é hora de revisar e fazer commit. Requer Claude Code 2.1.287 ou posterior.

A gravação inicia o Claude Code com o mod carregado em um pequeno projeto de demonstração. Antes do primeiro prompt, a faixa acima da entrada já mostra a branch e o número de arquivos alterados. Em seguida, o Claude recebe o pedido de listar os arquivos em src; a faixa continua no lugar enquanto o turno roda e é atualizada quando o turno termina.

Use qualquer um dos três métodos do bloco de instalação. O método de uma linha funciona dentro de uma sessão em andamento; o método pelo shell precisa de /reload-plugins nas sessões que já estão abertas.

O mod guarda o status mais recente do git em um átomo $.state e o desenha no ponto de renderização AbovePrompt. Estes são os hooks de hooks/register.tsx:

on('session.start', async ($, e, next) => {
  const started = await next(e)
  await refresh($)
  $.clock.every(intervalMs, () => {
    refresh($).catch(() => undefined)
  })
  return started
})

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (e.agentId === undefined) await refresh($)
  return result
})

on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  const ran = await next(e)
  if (mentionsGit(e.command)) await refresh($)
  return ran
}).catch(($, e, next) => next(e))

Há três pontos de atualização. session.start faz a primeira leitura e inicia um temporizador para captar mudanças feitas fora do Claude Code. turn.complete atualiza depois de cada turno do loop principal; turnos de subagentes (com agentId) são ignorados. O hook tool.call para Bash deixa o comando rodar primeiro com await next(e) e só atualiza se o comando mencionar git ou gh pr checkout/merge. O .catch dele repassa a chamada, então uma falha no mod nunca bloqueia o seu comando.

refresh executa um único git status --porcelain=v1 -b em $.session.cwd(). Esse comando sozinho fornece a branch, o upstream, o ahead/behind e a lista de alterações, então não são necessárias chamadas separadas de rev-parse e rev-list. Uma função pura, parseStatus, em hooks/git.ts, trata repositórios novos sem commits e o HEAD destacado. Se o git estiver ausente ou lento, a faixa é escondida em vez de mostrar dados desatualizados.

Altere estas opções em /config, sob o nome do mod; o mod recarrega com os novos valores. O padrão do temporizador é definido no início de register, Math.max(2_000, ... 15_000), que também impõe o mínimo de 2 segundos. Para mudar a aparência da faixa, edite os elementos Text no hook ui.render: a branch é desenhada em bold e cyan, e os detalhes em dimColor.

Executa comandos aparece porque o mod chama $.process.run. Ele executa exatamente dois programas: git status --porcelain=v1 -b e, somente quando o HEAD está destacado, git rev-parse --short HEAD. Os dois são somente leitura, usam um array argv sem shell e têm timeout de 10 segundos.

Intercepta chamadas de ferramentas aparece porque ele usa o hook tool.call para Bash. Ele apenas observa: nunca altera nem nega um comando, e atualiza depois que o comando termina. Altera a interface cobre a faixa.

Ele não lê o conteúdo de arquivos, não usa a rede e não chama o modelo. Para desligá-lo de vez, execute /plugin disable cm-git-branch; para iniciar uma sessão com todos os mods desligados, use claude --safe-mode.

Testado com Claude Code 2.1.291 no macOS, no terminal. Se a faixa não aparecer, verifique estes pontos na ordem:

• claude --version é 2.1.287 ou posterior.
• A sessão foi iniciada dentro de um repositório git; git status na mesma pasta deve funcionar.
• O mod está ativado: o menu /plugin o mostra na aba Installed, com uma linha "mod active".
• Você instalou pelo shell com uma sessão aberta: execute /reload-plugins.
• Uma pesquisa ou outro prompt está aberto acima da entrada. A faixa sai do caminho enquanto ele está visível e volta depois.

Em repositórios muito grandes, aumente intervalMs para que o git status rode com menos frequência.