GitAgent: An Open Standard for Portable AI Agents in Git Repos

What GitAgent Does

GitAgent addresses the problem of AI agent framework lock-in by creating a portable agent definition that works across multiple platforms. Instead of rewriting agents when switching frameworks, developers can define agents as files in a git repository that export to Claude Code, OpenAI Agents SDK, CrewAI, Google ADK, LangChain, and others.

Core Specification

The standard uses three required files:

• agent.yaml - Configuration file
• SOUL.md - Personality and instructions
• SKILL.md - Capabilities definition

Git-Native Benefits

By being git-native, GitAgent provides several built-in advantages:

• Version control for agent behavior - roll back bad prompts like reverting commits
• Branching for environment promotion (dev → staging → main)
• Human-in-the-loop via PRs - agents can open branches for human review
• Audit trail via git blame and git diff
• Agent forking and remixing - fork public agents, customize, and PR improvements back
• CI/CD integration with GitAgent validate in GitHub Actions

CLI Usage

The command-line interface allows direct execution of agent repositories:

npx @open-gitagent/gitagent run -r https://github.com/user/agent -a claude

Optional Compliance Features

For organizations needing compliance controls, GitAgent offers:

• Risk tier management
• Regulatory mappings (FINRA, SEC, SR 11-7)
• Audit reports via GitAgent audit

Availability

The specification is available at https://gitagent.sh with code on GitHub. The developers are seeking feedback on schema design and adapter priorities for future development.