Install

The ag2 install command is a package manager for AI development artifacts. It fetches content from the AG2 Resource Hub and installs it into your project or IDE.

Artifact Types#

Type	Description
Skills	Rules, workflows, and agent instructions installed into your IDE
Templates	Full project scaffolds with dependencies and config
Tools	Python functions (`@tool`) or MCP servers
Datasets	Evaluation data for testing agents
Agents	Pre-built subagents (e.g., Claude Code agents)
Bundles	Curated collections of multiple artifact types

Commands#

Install artifacts#

ag2 install skills [names...]         # Install IDE skills
ag2 install template <name>           # Scaffold from template
ag2 install tool <name>               # Install a tool or MCP server
ag2 install dataset <name>            # Install evaluation dataset
ag2 install agent <name>              # Install a subagent
ag2 install bundle <name>             # Install a curated bundle

Manage artifacts#

ag2 install list [type]               # List available artifacts
ag2 install search <query>            # Search the registry
ag2 install update [names...]         # Update installed artifacts
ag2 install uninstall <name>          # Remove an installed artifact
ag2 install from <path>               # Install from local path

IDE Target Detection#

The install system auto-detects your IDE and installs skills in the right format:

IDE	Detection
Claude Code	`.claude/` directory or `CLAUDE.md` file
Cursor	`.cursor/` directory
GitHub Copilot	`.copilot/` directory

You can also specify a target explicitly:

ag2 install skills --target claude

Examples#

Install skills into your IDE:

ag2 install skills ag2 fastapi react

Scaffold a project from a template:

ag2 install template fullstack-agentic-app --var project_name=my-app

Install an MCP tool (auto-configures IDE MCP settings):

ag2 install tool github-mcp

Search for artifacts:

ag2 install search "web scraping" --type tool

Lockfile#

Installed artifacts are tracked in ~/.ag2-artifacts.lock, enabling version-aware updates and clean uninstalls.