Skip to content

marian2js/opengoat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

573 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OpenGoat

Build AI Autonomous Organizations of OpenClaw Agents.

MIT License npm version CI Node >= 20.11 Discord

OpenGoat allows you to build herarchical organizations of AI agents that coordinate work across multiple tools, including Claude Code, Codex, Cursor, GitHub Copilot CLI, Lovable, and more.

OpenGoat UI


Installation

# Install OpenClaw and OpenGoat
npm i -g openclaw opengoat

# Setup OpenClaw
openclaw onboard

# Start OpenGoat
opengoat start

That's it. Open http://127.0.0.1:19123 and start messaging Goat, your AI co-founder.

Alternative: Docker

docker build -t opengoat:latest .
docker run --rm -p 19123:19123 -v opengoat-data:/data/opengoat opengoat:latest

Then open http://127.0.0.1:19123.

From Source (without global npm install)

pnpm install
pnpm build
./bin/opengoat --help

Documentation (Mintlify)

cd docs
mintlify dev

Use mintlify broken-links before publishing documentation changes.

When agents execute commands from their OpenGoat workspace, use the workspace shim:

sh ./opengoat agent list
sh ./opengoat agent info goat

CLI Quick Start (Optional)

Runtime: Node >=20.11.

npm i -g openclaw opengoat
openclaw onboard
opengoat init
opengoat agent --message "Set up a CTO and two engineers for this project."

Run the production UI server from the CLI:

opengoat start

Restart a running UI server:

opengoat restart

Use an external OpenClaw gateway:

opengoat onboard --external \
  --gateway-url ws://host:18789 \
  --gateway-token <token> \
  --non-interactive

Typical Workflows

Build the organization

opengoat agent create "CTO" --manager --reports-to goat
opengoat agent create "Engineer" --individual --reports-to cto --skill coding
opengoat agent create "Designer" --individual --reports-to cto
opengoat agent list

Run role-based work

opengoat agent cto --message "Plan the Q2 engineering roadmap and split it into streams."
opengoat agent engineer --message "Implement the auth middleware for this sprint."

Configure the default entry agent

# Persist in config.json
opengoat agent set-default stone

# Or override at runtime
export OPENGOAT_DEFAULT_AGENT=stone

You can also set defaultAgent directly in ~/.opengoat/config.json.

Keep session continuity

opengoat agent goat \
  --session saaslib-planning \
  --message "Create a release checklist for v1.2"

opengoat agent goat \
  --session saaslib-planning \
  --message "Now draft the changelog"

Operate with tasks

opengoat task create --title "Ship auth" --description "Finish middleware + tests" --owner cto --assign engineer
opengoat task list --as engineer
opengoat task status <task-id> doing

Skills

opengoat skill install og-boards --from /path/to/skill
opengoat skill install jira-tools --from /path/to/skill
opengoat skill list --agent goat

Role skill behavior:

  • OpenClaw agents use role-specific board skills:
    • managers: og-board-manager
    • individuals: og-board-individual
  • Non-OpenClaw agents use one board skill: og-boards

License

MIT

About

Build organizations of OpenClaw agents that coordinate work across Codex, Claude Code, Cursor, OpenCode, and more 🐐 🐐 🐐

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages