vrc-get

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: Add the repository (if not yet added)

Third-party packages need their repository registered first. Check with vrc-get repo list — if the vendor isn't listed, add it:

vrc-get repo add <repository-url>

Step 2: Install the package

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 3: Verify

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

vrc-get repo add https://vpm.nadena.dev/vpm.json
vrc-get install -y nadena.dev.ndmf 1.5.0
vrc-get info project

Example: Install the latest lilToon

vrc-get repo add https://lilxyzw.github.io/vpm-repos/vpm.json
vrc-get install -y jp.lilxyzw.liltoon

Example: Search and install an unknown package

vrc-get search "avatar optimizer"
# Find the package ID from results, then:
vrc-get install -y <found-package-id>