GitAgent is an open standard and framework that allows developers to define, version, and run AI agents natively within Git repositories. It extracts an agent's configuration, logic, tools, and memory into a portable, version-controlled definition, moving them out of proprietary frameworks and into files like agent.yaml and SOUL.md. This approach allows developers to treat agent prompts and logic like code, enabling branching, pull requests for reviews, and full audit trails. It is framework-agnostic, meaning a single definition can be run across various platforms including Claude Code, OpenAI, CrewAI, and OpenClaw. GitAgent also features built-in support for regulatory compliance and deterministic multi-step workflows.
Open standard for defining, versioning, and running AI agents natively in Git repositories.
- Managing AI agent versions and rollbacks using Git commits
- Implementing human-in-the-loop reviews via Pull Requests for agent skill updates
- Running the same agent definition across multiple LLM providers
- Automating compliant code reviews and audits in regulated industries
- Building multi-agent systems with shared context in a monorepo
- To use GitAgent
- first install the CLI using 'npm install -g gitagent'. Use 'gitagent init' to scaffold a new agent repository. Define your agent's identity in SOUL.md and its configuration in agent.yaml. You can then run your agent using 'gitagent run' with your preferred adapter (e.g.
- -a claude) or export it to other frameworks using 'gitagent export'. Use standard Git commands to branch
- commit
- and review changes to your agent's logic.
