O que é Oobo?

Oobo é uma ferramenta revolucionária projetada para preencher a lacuna entre o controle de versão de código e o trabalho real envolvido no desenvolvimento de software, especialmente na era da codificação assistida por IA. Enquanto o Git rastreia meticulosamente as alterações de código, ele muitas vezes falha em capturar o contexto de por que essas alterações foram feitas. Oobo aborda isso agindo como um decorador Git, aumentando cada commit com contexto crucial de IA. Isso inclui detalhes sobre quais sessões de IA contribuíram para o código, os custos de token associados e a atribuição da autoria do código (IA vs. humano). Essencialmente, Oobo transforma o Git de um mero registro de código em um registro de trabalho abrangente, fornecendo visibilidade sem precedentes sobre o processo de desenvolvimento.

No cenário atual, os agentes de IA estão contribuindo cada vez mais para o código de produção, realizando commits, abrindo pull requests e executando pipelines. No entanto, o rastro de como esse software é construído se torna fragmentado e muitas vezes se perde. Oobo garante que essas informações vitais não fiquem invisíveis. Ele captura o que a IA estava tentando alcançar, os prompts usados, o número de agentes envolvidos, o raciocínio por trás das decisões técnicas e as conversas ou tentativas que levaram ao código final. Esse contexto detalhado é ancorado a cada commit, criando um registro durável e pesquisável do trabalho de desenvolvimento.

Funcionalidades Principais

• Enriquecimento de Contexto de IA: Aumenta os commits Git com detalhes da sessão de IA, contagens de tokens, atribuição de código (linhas de IA vs. humano) e o modelo usado.
• Integração Transparente com Git: Funciona perfeitamente com seu fluxo de trabalho Git existente, agindo como um decorador que passa operações de leitura para o Git com sobrecarga zero.
• Sistema de Memória Dupla:
  • Memória do Repositório: Metadados de âncora sincronizam via um branch órfão do Git, viajando com seu repositório para histórico compartilhado e enriquecido.
  • Memória do Desenvolvedor: Banco de dados local SQLite armazena transcrições e análises inter-projetos, incluindo uso de tokens e rastreamento de custos.
• Suporte Nativo a Agentes: Construído especificamente para agentes de IA, com saída JSON estruturada para comandos e hooks de ciclo de vida para integração perfeita com ferramentas como Cursor, Claude Code e Gemini CLI.
• TUI Interativa: Navegue e pesquise sessões de chat de IA diretamente do seu terminal.
• Análises e Atribuição: Fornece insights sobre o uso de tokens, atribuição de código e custo geral de desenvolvimento.
• Estatísticas de Desenvolvedor Compartilháveis: Gere cartões compartilháveis resumindo sua atividade de desenvolvimento e uso de IA.
• CLI Extensível: Oferece comandos para visualizar o histórico de commits enriquecido (oobo anchors), navegar por sessões (oobo sessions), analisar o uso (oobo stats) e mais.
• Camada de Inteligência de Engenharia Futura: Base para construir linhas do tempo semânticas, rastreamento de alinhamento, avaliação de risco e relatórios de clareza de nível executivo.

Como Usar Oobo

Começar com Oobo é simples:

1. Instalação: Instale o Oobo usando o script fornecido:

   curl -fsSL https://oobo.ai/install.sh | bash
   

2. Configuração: Configure o Oobo executando o comando de configuração. Isso detectará suas ferramentas de desenvolvimento e configurará as configurações necessárias:

   oobo setup
   

3. Use Como Git: Substitua seus comandos Git padrão por comandos Oobo para commits. Oobo capturará automaticamente o contexto de IA:

   oobo commit -m "fix auth middleware"
   oobo push origin main
   

4. Explore o Histórico: Visualize o histórico de commits enriquecido, incluindo o contexto de IA, usando o comando anchors:

   oobo anchors
   

5. Analise o Uso: Rastreie o uso de tokens, atribuição e outras análises:

   oobo stats
   

6. (Opcional) Alias Git: Para uma experiência completamente transparente, crie um alias para seus comandos Git para Oobo:

   oobo alias install
   # Agora você pode usar 'git commit ...' e ele será tratado pelo Oobo.
   

Para uso específico de agente, Oobo fornece flags --agent para saída JSON estruturada, garantindo integração perfeita em fluxos de trabalho automatizados.

Casos de Uso

• Equipes de Desenvolvimento Aumentadas por IA: Rastreie e gerencie contribuições de desenvolvedores humanos e agentes de IA, garantindo atribuição clara e compreensão do processo de desenvolvimento. Isso é crucial para manter a qualidade do código e a responsabilidade.
• Gerenciamento de Custos para Desenvolvimento de IA: Monitore e analise o uso de tokens e os custos associados de modelos de IA usados na geração e refatoração de código, permitindo melhor controle de orçamento e otimização.
• Depuração e Auditoria: Rastreie rapidamente as alterações de código de volta a sessões de IA específicas, prompts e decisões, acelerando significativamente a depuração e fornecendo uma trilha de auditoria clara para conformidade e segurança.
• Gerenciamento de Conhecimento para Desenvolvedores: Construa uma base de conhecimento pessoal e de equipe capturando o contexto, a justificativa e a evolução das alterações de código, facilitando a integração de novos membros e a retenção do conhecimento do projeto.
• Pesquisa e Desenvolvimento: Documente o processo experimental em P&D, capturando quais abordagens de IA foram tentadas, seus resultados e o código resultante, promovendo um ambiente de pesquisa mais transparente e reproduzível.

FAQ

• P: Com quais ferramentas de IA o Oobo se integra? R: Oobo é projetado para se integrar com várias ferramentas e plataformas de codificação de IA. Ele detecta e se configura automaticamente para ferramentas como Cursor, Claude Code, Gemini CLI e OpenCode. Ele também suporta hooks de ciclo de vida de agente para rastreamento de sessão em tempo real.

• P: O Oobo é compatível com meus repositórios Git existentes? R: Sim, o Oobo é construído para funcionar perfeitamente com repositórios Git existentes. Ele atua como um decorador, o que significa que seus comandos Git padrão são aprimorados e as operações de leitura passam pelo Git sem impacto no desempenho. O histórico enriquecido é armazenado em um branch órfão do Git.

• P: Como o Oobo lida com privacidade e segurança? R: Oobo captura o contexto de desenvolvimento, incluindo dados de sessão de IA e uso de tokens. A 'Memória do Desenvolvedor' é armazenada localmente em sua máquina. A 'Memória do Repositório' sincroniza via um branch órfão do Git, que pode ser compartilhado quando desejado. Os usuários têm controle sobre quais dados são armazenados e compartilhados.

• P: O Oobo pode ser usado por desenvolvedores individuais e equipes maiores? R: Com certeza. Oobo oferece valor para desenvolvedores individuais rastreando seu trabalho pessoal e uso de IA. Para equipes, ele constrói uma camada compartilhada de inteligência de engenharia, oferecendo insights sobre esforços colaborativos entre humanos e IA, alinhamento de projeto e risco.

• P: Qual é o modelo de precificação para Oobo? R: Oobo é de código aberto, lançado sob as licenças Apache 2.0 / MIT. A ferramenta CLI principal é gratuita para usar. Recursos futuros potenciais ou soluções empresariais podem ter modelos de precificação diferentes, mas a ferramenta fundamental é acessível a todos.