open-gitagent/gitagent

What is it?

Key features

• 01Agent identity, rules, memory and tools are stored as git-versioned files.
• 02Streaming SDK via query() with hooks for gating and modifying tool calls.
• 03Runs against a local directory or clones a GitHub repo onto a session branch.
• 04Acts as an MCP client, auto-registering tools from configured servers.
• 05Supports declarative YAML tools, skills and plugins.
• 06Optional OpenTelemetry tracing and audit logging.

Use cases

• Maintaining a personal or team AI assistant whose rules and memory are reviewed through git diffs.
• Forking a base agent and branching personality or rule variants.
• Running an agent against a GitHub repo to make fixes on a session branch.
• Embedding an agent in a Node.js app via the query() SDK with custom tools.

Quick start

1. 1

   Install the CLI and SDK via npm

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

   Set your OpenAI API key

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

   Run your first agent on a project directory

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

Things to know

• !You need an API key from a model provider such as OpenAI or Anthropic to run agents.
• !Voice mode and the web UI are a separate package, @open-gitagent/voice, and must be installed on their own.

Topics

FAQ

What is gitagent?

A git-native AI agent framework where an agent's identity, rules, memory, tools and skills live as version-controlled files in a repo. Gitagent treats an AI agent as a git repository. Its personality (SOUL.md), behavioral rules (RULES.md), memory (memory/), declarative YAML tools, composable skills and lifecycle hooks are all plain files, so an agent can be forked, branched, diffed and inspected with ordinary git commands.

Is gitagent free to use? What license does it have?

gitagent is open source under the MIT license. Check the license terms before using it in commercial products.

Is gitagent still maintained?

Actively maintained. The last commit to gitagent was on Oct 22, 2026.

What can I use gitagent for?

Maintaining a personal or team AI assistant whose rules and memory are reviewed through git diffs. Forking a base agent and branching personality or rule variants. Running an agent against a GitHub repo to make fixes on a session branch. Embedding an agent in a Node.js app via the query() SDK with custom tools.

How do I install gitagent?

Install the CLI and SDK via npm: npm install -g @open-gitagent/gitagent Set your OpenAI API key: export OPENAI_API_KEY="sk-..." Run your first agent on a project directory: gitagent --dir ~/my-project "Explain this project and suggest improvements"

Where can I get gitagent?

The source code and installation instructions are on GitHub: https://github.com/open-gitagent/gitagent