---
sidebarTitle: Install
title: "ag2 install"
description: "Install skills, templates, tools, datasets, agents, and bundles from the AG2 registry."
---

The `ag2 install` command is a package manager for AI development artifacts. It fetches content from the [AG2 Resource Hub](https://github.com/ag2ai/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

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

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

```bash
ag2 install skills --target claude
```

## Examples

Install skills into your IDE:

```bash
ag2 install skills ag2 fastapi react
```

Scaffold a project from a template:

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

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

```bash
ag2 install tool github-mcp
```

Search for artifacts:

```bash
ag2 install search "web scraping" --type tool
```

## Lockfile

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