GitAgent

GitAgent (formerly gitclaw) is an open-source CLI coding agent developed under the open-gitagent organization and associated with Lyzr. It is designed to operate directly within software repositories, enabling autonomous and semi-autonomous coding workflows, codebase analysis, and task execution directly from the terminal. Day-to-day operations can be executed against local directories or remote Git repositories using dedicated CLI flags such as `--repo`, `--pat`, and `--session`. The agent relies on a structured workspace specification—including `SOUL.md`, `RULES.md`, and `agent.yaml`—to constrain operational boundaries and agent personas. GitAgent supports modern foundation models including Claude and integrates with external developer tooling via Model Context Protocol (MCP) client capabilities. What differentiates GitAgent is its standardized Open Git Agent architecture combined with production-oriented developer tooling. It includes dedicated memory scaffolding for context persistence, an extensible global plugin ecosystem, and native OpenTelemetry (OTel) instrumentation for tracing execution spans, token usage, and tool invocations. GitAgent is an open-source project distributed via npm and GitHub. It requires no subscription fees beyond the user's standard model API provider costs.

Tags: agent harness, ai agent, cli, codebase, developer tools, OpenSource

Visit GitAgent

Key features

• Open Git Agent Format — Configures agent behavior, execution rules, and persona through standard SOUL.md, RULES.md, and agent.yaml files. - Repository Management Flags — Supports local and remote repository targeting via --repo, --pat, and --session CLI options. - Model Context Protocol (MCP) Client — Connects to local or remote MCP servers to dynamically discover and execute developer tools and data sources. - Built-in Memory Scaffolding — Persists session context and cross-session knowledge within dedicated repository memory structures. - OpenTelemetry Instrumentation — Emits native OTel trace spans for detailed visibility into agent reasoning, tool calls, and execution lifecycles. - Global Plugin Architecture — Allows developers to extend base agent capabilities by loading custom plugins from a global directory.

Use cases

Use Case: Rule-Enforced Code Modification Developers define repository conventions in RULES.md and instruct GitAgent to refactor functions or implement features while strictly adhering to established style, testing, and architecture requirements.

Use Case: MCP Tool Execution in Terminal Engineers connect GitAgent to external MCP servers to let the agent inspect live database schemas, issue trackers, or documentation APIs directly while generating implementation code.

Use Case: Monitored Agent Automation DevOps and platform engineers run GitAgent across automated CI/CD or local batch tasks with OpenTelemetry exports enabled to monitor latency, tool usage, and prompt behavior across long-running coding sessions.

Who it is for

GitAgent is built for software engineers, DevOps teams, and platform developers who want a customizable, scriptable CLI agent that supports MCP and OpenTelemetry tracing. It is less suited for developers seeking a standard graphical IDE extension or a zero-configuration chat assistant.

Install guide

Installation Install the package globally using npm: bash npm install -g gitagent

First Run Set your model provider API key and verify the installation: bash export ANTHROPIC_API_KEY="your-api-key-here" gitagent --help

Example Session Run GitAgent against your current repository with an active session: bash gitagent --repo . --session refactor-auth

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

• SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
• Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
• Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
• Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
• Stratless — Stratless is an open-source agent harness and execution orchestrator developed by the Stratless AI team. It provides a modular infrastructure…
• Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…