venpm

Vencord Plugin Manager — install and manage userplugins from JSON indexes.

Full documentation: venpm.dev

Install

npm install -g @kamaras/venpm

Or run without installing:

npx @kamaras/venpm doctor

Requires Node.js 18+.

Quick Start

venpm doctor                          # check environment
venpm config set vencord.path ~/Vencord

venpm search betterFolders            # find plugins
venpm install BetterFolders           # install a plugin
venpm list                            # list installed plugins
venpm update                          # update all plugins
venpm rebuild                         # rebuild Vencord

For Plugin Authors

venpm create my-plugins               # scaffold a new plugin repo
venpm create my-plugins/MyPlugin      # scaffold a plugin inside a repo
venpm validate plugins.json           # validate your index file

See Publishing Plugins for the full walkthrough.

How It Works

1. Authors publish a plugins.json index file (spec) somewhere reachable — GitHub Releases, a raw URL, or any static host.
2. Users add that URL with venpm repo add <url>.
3. venpm install <plugin> resolves dependencies, fetches via git or tarball, and optionally rebuilds Vencord.

Development

git clone https://github.com/theokyr/venpm.git && cd venpm
node scripts/setup.mjs

npm run dev          # watch mode
npm test             # 224 tests
npm run lint         # type check

License

MIT