CLI

Installing Vengeance UI with the shadcn CLI

Initialization

Use the init command to initialize a new shadcn project before adding registry components.

bashnpx shadcn@latest init

code

Which style would you like to use? New York
Which color would you like to use as base color? Zinc
Do you want to use CSS variables for colors? yes

Add components

Use the add command with the Vengeance UI registry URL from any component page.

bashnpx shadcn@latest add https://raw.githubusercontent.com/Ashutoshx7/VengeanceUI/main/public/r/animated-rays.json

code

Usage: shadcn add [options] [components...]

add a component to your project

Arguments:
  components        the components to add or a url to the component.

Options:
  -y, --yes         skip confirmation prompt
  -o, --overwrite   overwrite existing files
  -c, --cwd <cwd>   the working directory
  -p, --path <path> the path to add the component to
  -h, --help        display help for command

Monorepo

In a monorepo, pass the workspace path with -c or --cwd.

bash

npx shadcn@latest add https://raw.githubusercontent.com/Ashutoshx7/VengeanceUI/main/public/r/animated-rays.json -c ./apps/web

Namespaced registry

If you prefer short component names, add a registry alias to components.json.

components.json

{
  "registries": {
    "@vengeanceui": "https://raw.githubusercontent.com/Ashutoshx7/VengeanceUI/main/public/r/{name}.json"
  }
}

bashnpx shadcn@latest add @vengeanceui/animated-rays

Agent skill + MCP

Install the VengeanceUI agent skill, MCP server config, and instructions. In a terminal, init lets you arrow through Cursor, Claude, both, or MCP only, then confirm MCP config.

bashnpx vengeanceui init

code

? Agent
❯ Cursor     skill, AGENTS.md
  Claude     skill, CLAUDE.md
  Both       Cursor + Claude
  MCP only   server config

? Configure MCP server? (Y/n)

Skip the prompts with a target, or -y for Cursor + Claude + MCP (also the default when stdin is not a TTY):

code

npx vengeanceui init cursor
npx vengeanceui init claude
npx vengeanceui init mcp
npx vengeanceui init -y

MCP configs use npx -y vengeanceui-mcp. This does not replace shadcn init / add for installing components.

Contributors cloning this repo can keep using a local MCP build at packages/mcp:

.cursor/mcp.json

{
  "mcpServers": {
    "vengeance-ui": {
      "command": "node",
      "args": ["${workspaceFolder}/packages/mcp/dist/index.js"]
    }
  }
}

Build the server first: cd packages/mcp && npm install && npm run build.