openagent

The npm for AI Agents — Git-first CLI for managing AI coding agents.

Install

npm install -g @openagentshub/openagent

Quick Start

# Create a base template for a new agent
openagent create my-new-agent

# Install an agent
openagent install typescript-expert

# Install specific versions (recommended examples)
openagent install typescript-expert --version 1.1.0
openagent install react-performance --version 1.1.0
openagent install aws-serverless-typescript --version 1.1.0

# Pull updates
openagent pull

# Publish an agent
openagent publish

# Run diagnostics
openagent doctor

Configuration

Priority Order

1. CLI flags (highest)
2. Project config (openagent.config.yaml)
3. Global config (~/.openagent/config.yaml)
4. Environment variables (OPENAGENT_*)
5. Default (official registry)

Switch to a private registry

openagent config set registry.repo [email protected]:company/internal-agents.git
openagent config set registry.branch main

Project-level config

Create openagent.config.yaml in your project root:

registry:
  provider: github
  repo: https://github.com/openagentshub/openagents
  branch: main

Commands

| Command | Description | | ------------------------------------ | ------------------------------------ | | openagent create <name> | Create a local base agent template | | openagent install <name> | Install an agent from the registry | | openagent pull [name] | Pull updates for installed agents | | openagent push <name> | Push an agent to the registry | | openagent publish | Publish agent from current directory | | openagent config set <key> <value> | Set configuration | | openagent config get [key] | Get configuration | | openagent config list | List all configuration | | openagent remote | Show registry remote info | | openagent doctor | Run diagnostic checks |

Install Location

openagent install now resolves install path by agent provider/IDE:

• copilot → .github/agents/<agent-name>/
• cursor → .cursor/agents/<agent-name>/
• claude-code → .claude/agents/<agent-name>/
• codeium → .codeium/agents/<agent-name>/
• tabnine → .tabnine/agents/<agent-name>/

License

MIT