CLI

The Identity Forge CLI installs and exports design kits from the terminal. It ships as an npm package and runs without an account.

Installation

npm install -g identityforge

Or run commands directly with npx:

npx identityforge@latest <command>

Commands

init

Interactive setup. Walks you through picking a kit and writes the design tokens into your project.

identityforge init

kits list

List available kits.

identityforge kits list
identityforge kits list --style minimal
identityforge kits list --json

kits search

Search kits by style, mood, or keyword.

identityforge kits search --query "warm corporate"
identityforge kits search --style bold --mood vibrant

kit info <slug>

Show details for a specific kit.

identityforge kit info aurora-dawn

kit install <slug>

Install a kit into your project.

identityforge kit install aurora-dawn
identityforge kit install aurora-dawn --format css
identityforge kit install aurora-dawn --format tailwind --output ./src/styles/

Formats: css, tailwind, design-md, json, style-dictionary, shadcn

kit export <slug>

Export a kit without installing it (prints to stdout).

identityforge kit export aurora-dawn --format design-md
identityforge kit export aurora-dawn --format json > tokens.json

mcp

Start the MCP server. Used in agent configurations, not typically called directly.

identityforge mcp

See MCP server for setup details.

login

Authenticate with your Identity Forge account (required for Pro kits only).

identityforge login

whoami

Show the currently authenticated user.

identityforge whoami

Global flags