automagent install

Install agent.yaml as native IDE agent files for Claude Code, Cursor, and Copilot

Usage

$ automagent install [target] [path] [options]

Both arguments are optional. Without a [target], the CLI auto-detects which IDEs are present. The [path] defaults to ./agent.yaml.

Flag	Description	Default
`--global`	Install to user-level agent directory	Off
`--force`	Overwrite existing files	Off

Target	Output files	Global directory
`claude-code`	`.claude/CLAUDE.md`	`~/.claude/agents/`
`cursor`	`.cursor/.cursorrules` or `.mdc`	Not supported
`copilot`	`.github/copilot-instructions.md`	`~/.copilot/agents/`

Reads and validates the local agent.yaml
Determines which targets to install to:
- If a target is specified, installs only to that target
- Otherwise, detects IDE directories (.claude, .cursor, .github) in the current project
- If no IDE directories are found, installs to all targets
Generates native agent files for each target
Writes the files to the project directory (or the global agent directory with --global)

Auto-detect IDEs and install:

$ automagent install

Install for a specific IDE:

$ automagent install claude-code

Install from a different agent file:

$ automagent install cursor ./agents/support.yaml

Install globally (user-level):

$ automagent install claude-code --global

Overwrite existing files:

$ automagent install --force

The command validates agent.yaml against the schema before installing. Invalid definitions are rejected.
Use --global to install agents to your user-level directory so they are available across all projects. Cursor does not support global agents and will be skipped.
Without --force, existing files are not overwritten. The CLI prints an error for each file that already exists.