open-index/open-npm huggingface dataset:
npm package: @openagentshub/openagent
Description: The npm for AI Agents — Git-first CLI for managing AI coding agents
Author: OpenAgentsHub
Latest version: 0.0.9

# openagent

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

## Install

```bash
npm install -g @openagentshub/openagent
```

## Quick Start

```bash
# 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

```bash
openagent config set registry.repo git@github.com:company/internal-agents.git
openagent config set registry.branch main
```

### Project-level config

Create `openagent.config.yaml` in your project root:

```yaml
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