open-gitagent/gitagent

Registry

Summary

GitAgent is a universal, git-native AI agent framework where your agent's identity, rules, memory, tools, and skills are all stored as version-controlled files inside a git repository. Built with TypeScript, it enables seamless collaboration between human developers and AI agents through the familiar git workflow.

Key features

• Git-native architecture: all agent configurations are version-controlled files
• Modular skill system with versioned tools and rules
• Persistent memory stored as git-tracked files
• Built-in identity and rule management via repository structure
• TypeScript-based for extensibility and type safety
• Seamless integration with existing git workflows

Use cases

• Automated code review and pull request management
• Personal AI assistant for software development projects
• Team collaboration with AI agents in shared repositories
• Version-controlled AI agent behavior for reproducible experiments
• Custom tool and skill development for specialized workflows

README excerpt

<p align="center"> <img src="./gitagent-logo.png" alt="GitAgent Logo" width="200" /> </p> <p align="center"> <img src="https://img.shields.io/npm/v/gitagent?style=flat-square&color=blue" alt="npm version" /> <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square" alt="node version" /> <img src="https://img.shields.io/github/license/open-gitagent/gitagent?style=flat-square" alt="license" /> <img src="https://img.shields.io/badge/TypeScript-5.7-blue?style=flat-square&logo=typescript&logoColor=white" alt="typescript" /> </p> <h1 align="center">Gitagent</h1> <p align="center"> <strong>A universal git-native multimodal always learning AI Agent (TinyHuman)</strong><br/> Your agent lives inside a git repo — identity, rules, memory, tools, and skills are all version-controlled files. </p> <p align="center"> <a href="#one-command-install">Install</a> &bull; <a href="#quick-start">Quick Start</a> &bull; <a href="#sdk">SDK</a> &bull; <a href="#architecture">Architecture</a> &bull; <a href="#tools">Tools</a> &bull; <a href="#hooks">Hooks</a> &bull; <a href="#skills">Skills</a> &bull; <a href="#plugins">Plugins</a> </p> --- ## Why Gitagent? Most agent frameworks treat configuration as code scattered across your application. Gitagent flips this — **your agent IS a git repository**: - **`agent.yaml`** — model, tools, runtime config - **`SOUL.md`** — personality and identity - **`RULES.md`** — behavioral constraints - **`memory/`** — git-committed memory with full history - **`tools/`** — declarative YAML tool definitions - **`skills/`** — composable skill modules - **`hooks/`** — lifecycle hooks (script or programmatic) Fork an agent. Branch a personality. `git log` your agent's memory. Diff its rules. This is **agents

Topics