CLI

The Identity Forge CLI gives people and coding agents the same design kits, naming workflow, domain evidence, and brand-project tools as the MCP server. Public Free kits work without an account.

Installation

npm install -g identityforge

Or run the current version without installing it:

npx --yes identityforge@latest <command>

Design-kit commands

themes

List the catalog. Pass a brief with --query to return the full catalog with the brief alongside it for the calling agent to rank.

identityforge themes
identityforge themes --query "calm fintech dashboard"

themes get <id-or-slug>

Read one kit without writing files.

identityforge themes get ambient-sage
identityforge themes get ambient-sage --format css
identityforge themes get ambient-sage --format json

Export formats: design-md, dtcg, css, tailwind-v3, tailwind-v4, shadcn-registry, and json.

apply <slug>

Write DESIGN.md, a token file, and identityforge.json into a project. The default format is dtcg.

identityforge apply ambient-sage --preview
identityforge apply ambient-sage --format css
identityforge apply ambient-sage --format tailwind-v4 --dir ./apps/web

The command plans every file before writing. It writes nothing when an untracked or locally edited file conflicts. --force overwrites conflicting content permanently, so preview and review the conflict list first.

status

Read the committed stamp and report whether the kit version, rendered DESIGN.md, document contract, or local artifacts moved.

identityforge status
identityforge status --dir ./apps/web

Agent setup

Install the local MCP server into a supported client:

identityforge install --client claude-code
identityforge install --client cursor
identityforge install --client vscode
identityforge install --client codex

Also supported: gemini, opencode, and pi.

mcp

Run the MCP server over stdio. Agent configurations call this command for you.

identityforge mcp

See MCP server for setup details.

Account commands

identityforge login
identityforge whoami
identityforge logout

Authentication is needed for persistent projects, saved work, authenticated quota, and Pro kits. whoami reports the active plan, scopes, quota, AI credits, and saved-kit slots.

More commands

The CLI also exposes brand projects, client shares, mockups, naming projects, evidence checks, domain checks, font discovery, kit version history, and deltas. Run identityforge --help or identityforge <command> --help for the checked command surface installed on your machine.

Telemetry

First-party CLI and MCP requests carry a random reference that lasts only for the current process. An apply reports one bounded result: files written, artifacts already current, safe conflict refusal, or failure stage. It sends no paths, filenames, repository names, file contents, prompts, or exception text. Set IDENTITYFORGE_TELEMETRY=0 to omit the process reference and local outcome reports.