01 — O problema
O estado do workspace fica fragmentado entre repositórios.
Git responde com precisão a perguntas sobre um repositório. Essas informações, porém, continuam distribuídas quando o ambiente de trabalho passa a conter muitos projetos independentes.
Branch atual, working tree, upstream, histórico, refs e divergências são propriedades locais a cada repositório. À medida que o número de projetos cresce, perguntas simples passam a exigir navegação manual, scripts específicos ou memória humana.
Quais repositórios existem nesta máquina? Quais possuem trabalho local pendente? Quais worktrees pertencem ao mesmo repositório? Quais observações ainda representam o estado atual? Onde uma inspeção falhou?
O problema não está no Git. Essas perguntas pertencem a uma camada acima dele.
02 — A solução
Um inventário persistente e observável do workspace local.
BullSaddle constrói uma representação própria do ambiente Git sem assumir autoridade sobre os repositórios.
A ferramenta descobre repositórios e worktrees, preserva suas identidades, registra observações e permite consultar posteriormente o estado consolidado do workspace.
Git continua sendo a fonte de verdade sobre o estado dos repositórios. BullSaddle mantém a visão operacional sobre o conjunto.
Essa separação permite observar muitos repositórios sem introduzir um novo sistema de versionamento, um novo formato de repositório ou uma segunda semântica para commits e branches.
03 — Como funciona
Descobrir. Observar. Consultar.
O modelo operacional separa explicitamente inventário, observação e leitura do estado já registrado.
discover identifica os repositórios presentes nas áreas solicitadas e atualiza o inventário local. refresh observa seu estado Git e registra novas observações. Consultas como repos, inspect e overview leem o que foi descoberto e observado.
Descoberta e observação não acontecem silenciosamente durante uma consulta. A idade das observações permanece explícita, e uma falha em determinado caminho, worktree ou processo Git pode ser registrada sem transformar todo o workspace em uma operação indivisível.
O resultado é uma distinção clara entre o que existe, o que foi observado e quando essa observação foi produzida.
04 — O que se torna visível
O workspace passa a ser uma entidade consultável.
BullSaddle reúne em uma única visão informações que normalmente precisam ser inspecionadas repositório por repositório.
O inventário distingue repositórios, worktrees e localizações físicas. As observações podem registrar estado da working tree, branch e HEAD, relação com upstream, divergência local/remota, diagnósticos e freshness. Consultas também podem produzir saída estruturada para integração com outras ferramentas e automações.
Sobre esse estado observado, o BullSaddle pode produzir advisories determinísticos sem transformar heurísticas em fatos e sem depender de inteligência artificial para compreender o workspace.
05 — Fronteiras
Observar Git não significa controlar Git.
BullSaddle é read-only em relação aos repositórios observados.
Descoberta, atualização e consultas não criam commits, branches, refs, worktrees ou stashes e não modificam index ou arquivos da working tree. Também não executam implicitamente fetch, pull, push ou clone.
A ferramenta pode atualizar apenas seu próprio estado persistente — inventário, observações e metadados necessários para representar o workspace.
A fronteira é simples: Git controla o repositório; BullSaddle observa o ambiente ao redor dele.
06 — Projeto
Engenharia local-first, com Git permanecendo no centro.
BullSaddle é desenvolvido em Rust pela Orion Impact e distribuído sob a licença Apache 2.0. A versão pública atual é 0.2.0; o target nativo atualmente certificado é x86_64-unknown-linux-gnu.
O repositório público contém código-fonte, documentação técnica, instruções de build, referência da CLI e os detalhes necessários para utilizar ou estudar a implementação.