Repolode
Enviar
open-gitagent

open-gitagent/gitagent

Um framework de agentes de IA nativo do Git, em que a identidade, as regras, a memória, as ferramentas e as habilidades do agente ficam em arquivos versionados em um repositório.

Ver no GitHub
Estrelas
720
Forks
138
Issues abertas
60
Último commit
há 8 horas

O que é?

O Gitagent trata um agente de IA como um repositório Git. Sua personalidade (SOUL.md), regras de comportamento (RULES.md), memória (memory/), ferramentas declarativas em YAML, habilidades combináveis e hooks de ciclo de vida são todos arquivos comuns. Assim, é possível fazer fork, criar branches, comparar diferenças e inspecionar um agente com comandos Git comuns.

O projeto é distribuído como CLI (`gitagent`) e SDK, que expõe a função de streaming `query()`. A CLI pode executar em um diretório local ou clonar um repositório do GitHub, trabalhando em uma branch de sessão que é commitada e enviada automaticamente. O acesso aos modelos é feito via pi-ai, com suporte a provedores como Anthropic, OpenAI, Google, xAI, Groq e Mistral; os modelos de fallback podem ser configurados em agent.yaml.

O framework também funciona como cliente MCP, registrando ferramentas de servidores MCP configurados por stdio ou HTTP. Além disso, inclui plugins, delegação para subagentes, configurações de conformidade com logs de auditoria em .gitagent/audit.jsonl e rastreamento opcional com OpenTelemetry.

Recursos principais

  • 01A identidade, as regras, a memória e as ferramentas do agente são armazenadas em arquivos versionados pelo Git.
  • 02SDK de streaming via query(), com hooks para controlar e modificar chamadas de ferramentas.
  • 03Executa em um diretório local ou clona um repositório do GitHub para uma branch de sessão.
  • 04Funciona como cliente MCP e registra automaticamente ferramentas de servidores configurados.
  • 05Oferece suporte a ferramentas declarativas em YAML, habilidades e plugins.
  • 06Rastreamento opcional com OpenTelemetry e registro de auditoria.

Casos de uso

  • Manter um assistente de IA pessoal ou para uma equipe, com regras e memória revisadas por meio de diferenças do Git.
  • Fazer fork de um agente base e criar branches com variações de personalidade ou regras.
  • Executar um agente em um repositório do GitHub para fazer correções em uma branch de sessão.
  • Integrar um agente a um app Node.js usando o SDK query() e ferramentas personalizadas.

Início rápido

  1. 1

    Instale a CLI e o SDK via npm

    npm install -g @open-gitagent/gitagent
  2. 2

    Configure sua chave de API da OpenAI

    export OPENAI_API_KEY="sk-..."
  3. 3

    Execute seu primeiro agente em um diretório de projeto

    gitagent --dir ~/my-project "Explain this project and suggest improvements"

Antes de usar

  • Você precisa de uma chave de API de um provedor de modelos, como OpenAI ou Anthropic, para executar agentes.
  • O modo de voz e a interface web são um pacote separado, @open-gitagent/voice, e devem ser instalados à parte.

Tópicos

#ai-agents#llm#git#mcp#agent-framework#typescript#sdk#anthropic#assistant#openclaw

Perguntas frequentes

O que é gitagent?
Um framework de agentes de IA nativo do Git, em que a identidade, as regras, a memória, as ferramentas e as habilidades do agente ficam em arquivos versionados em um repositório. O Gitagent trata um agente de IA como um repositório Git. Sua personalidade (SOUL.md), regras de comportamento (RULES.md), memória (memory/), ferramentas declarativas em YAML, habilidades combináveis e hooks de ciclo de vida são todos arquivos comuns. Assim, é possível fazer fork, criar branches, comparar diferenças e inspecionar um agente com comandos Git comuns.
gitagent é gratuito? Qual é a licença?
gitagent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
gitagent ainda é mantido?
Manutenção ativa. O último commit de gitagent foi em 22 de out. de 2026.
Para que posso usar gitagent?
Manter um assistente de IA pessoal ou para uma equipe, com regras e memória revisadas por meio de diferenças do Git. Fazer fork de um agente base e criar branches com variações de personalidade ou regras. Executar um agente em um repositório do GitHub para fazer correções em uma branch de sessão. Integrar um agente a um app Node.js usando o SDK query() e ferramentas personalizadas.
Como instalar gitagent?
Instale a CLI e o SDK via npm: npm install -g @open-gitagent/gitagent Configure sua chave de API da OpenAI: export OPENAI_API_KEY="sk-..." Execute seu primeiro agente em um diretório de projeto: gitagent --dir ~/my-project "Explain this project and suggest improvements"
Onde consigo gitagent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/open-gitagent/gitagent

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

Projetos relacionados