Get Started with gitagent

When to Use

When a user is new to gitagent, wants to set up their first agent, or asks "how do I start?"

Instructions

Installation

npm install -g @open-gitagent/gitagent
gitagent --version

Create Your First Agent

Walk the user through these steps:

1. Scaffold — Pick a template:

   # Minimal (2 files)
   gitagent init --template minimal --dir ./my-agent
   
   # Standard (with skills, tools, knowledge)
   gitagent init --template standard --dir ./my-agent
   
   # Full (compliance, hooks, memory, workflows)
   gitagent init --template full --dir ./my-agent
   

2. Edit — Customize agent.yaml (name, description, model) and SOUL.md (identity, personality)

3. Validate — Check your work:

   gitagent validate -d ./my-agent
   

4. Run — Launch with Claude:

   gitagent run -d ./my-agent
   

5. Share — Push to git and anyone can run it:

   cd my-agent && git init && git add . && git commit -m "Initial agent"
   # Push to GitHub, then:
   gitagent run -r https://github.com/you/my-agent
   

Minimum Required Files

• agent.yaml — name, version, description (required)
• SOUL.md — agent identity (required)
• Everything else is optional