---
name: vrc-get
description: Install, remove, and manage VRChat VPM packages using the vrc-get CLI. Use this skill whenever the user wants to install or add VPM packages (e.g. NDMF, lilToon, Modular Avatar, Avatar Optimizer, VRChat SDK), search for packages, manage VPM repositories, resolve Unity project dependencies, or run any vrc-get command. Trigger on mentions of package IDs like nadena.dev.ndmf, jp.lilxyzw.liltoon, com.vrchat.avatars, com.anatawa12.avatar-optimizer, VPMパッケージ, vrc-get, or requests to add/update/remove packages in a Unity VRChat project.
---

# vrc-get — VRChat Package Manager CLI

`vrc-get` is an open-source VPM (VRChat Package Manager) client for managing packages in Unity VRChat projects.

## Quick Reference

| Goal | Command |
|------|---------|
| Install latest | `vrc-get install -y <package-id>` |
| Install specific version | `vrc-get install -y <package-id> <version>` |
| Remove a package | `vrc-get remove <package-id>` |
| Upgrade a package | `vrc-get upgrade <package-id>` |
| Resolve all deps | `vrc-get resolve` |
| Show installed packages | `vrc-get info project` |
| Search for a package | `vrc-get search <query>` |
| Add a repository | `vrc-get repo add <url>` |
| List repositories | `vrc-get repo list` |

## Installation Workflow

### Step 1: Search for the package

`vrc-get search` only looks through repositories that are already registered, so start here rather than assuming a repo add is needed — most official and previously-used third-party repos are already registered, and searching first avoids adding duplicate or unnecessary repositories.

```bash
vrc-get search <package-name-or-id>
```

- **Found** — note the exact package ID from the results and skip to Step 3.
- **Not found** — the vendor's repository is probably not registered yet; go to Step 2.

### Step 2: Add the repository (only if the search came up empty)

Look up the vendor in "Common Repositories & Packages" below for the repository URL. If it's not listed there, ask the user for the URL rather than guessing one.

```bash
vrc-get repo add <repository-url>
```

Re-run `vrc-get search <package-name-or-id>` to confirm the package now resolves before installing.

### Step 3: Install the package

```bash
vrc-get install -y <package-id>               # latest stable version
vrc-get install -y <package-id> <version>     # specific version (e.g. 1.5.0)
vrc-get install -y --prerelease <package-id>  # include prerelease builds
```

The `-y` flag skips the interactive confirmation prompt — always include it in scripts or automated contexts.

### Step 4: Verify

```bash
vrc-get info project
```

This shows locked packages (pinned in `vpm-manifest.json`) and other installed packages.

---

## Common Repositories & Packages

### Official VRChat (built-in, no `repo add` needed)
- `com.vrchat.base` — VRChat Base SDK
- `com.vrchat.avatars` — VRChat Avatars SDK

### Nadena (bd_)
Repository: `https://vpm.nadena.dev/vpm.json`
- `nadena.dev.ndmf` — Non-Destructive Modular Framework (NDMF)
- `nadena.dev.modular-avatar` — Modular Avatar

Prerelease channel: `https://vpm.nadena.dev/vpm-prerelease.json`

### lilxyzw
Repository: `https://lilxyzw.github.io/vpm-repos/vpm.json`
- `jp.lilxyzw.liltoon` — lilToon shader

### anatawa12
Repository: `https://vpm.anatawa12.com/vpm.json`
- `com.anatawa12.avatar-optimizer` — Avatar Optimizer (AAO)

### kurotu (VRCQuestTools)
Repository: `https://kurotu.github.io/vpm-repos/vpm.json`
- `com.github.kurotu.vrc-quest-tools` — VRCQuestTools

---

## Tips

- **Version format:** Semantic versioning without `v` prefix — e.g., `1.5.0`, `3.9.0`.
- **"latest":** Simply omit the version argument to get the latest stable release.
- **After `git pull`:** Run `vrc-get resolve` to reinstall all packages defined in `vpm-manifest.json`.
- **Outdated packages:** `vrc-get outdated` lists packages with newer versions available.
- **CI helper script:** This project includes `scripts/vrc-get-install.sh <id> <version|"latest">` which wraps `vrc-get install -y` and handles the `"latest"` string correctly for use in CI matrix jobs.

---

## Example: Install NDMF 1.5.0

```bash
vrc-get search nadena.dev.ndmf
# If not found, the repo isn't registered yet:

vrc-get repo add https://vpm.nadena.dev/vpm.json
vrc-get search nadena.dev.ndmf   # confirm it resolves now
vrc-get install -y nadena.dev.ndmf 1.5.0
vrc-get info project
```

## Example: Install the latest lilToon (repo already registered)

```bash
vrc-get search jp.lilxyzw.liltoon
# Found -> repo add is unnecessary, install directly:
vrc-get install -y jp.lilxyzw.liltoon
```

## Example: Search and install an unknown package

```bash
vrc-get search "avatar optimizer"
# Not found in any registered repo -> check "Common Repositories & Packages"
# for the vendor's URL (or ask the user), then add it and search again:
vrc-get repo add https://vpm.anatawa12.com/vpm.json
vrc-get search "avatar optimizer"
vrc-get install -y <found-package-id>
```