mint-cli

name	mint-cli
description	Guide for querying Sailwind design tokens using the Mint CLI. Use when looking up colors, typography, spacing, or semantic tokens for UI components in this project.

Mint Design Token CLI

Mint is a CLI tool that queries Sailwind design tokens. Use it to look up colors, typography, spacing, and semantic tokens when building UI components.

Setup

Mint is not yet published to npm. To use it, clone the repo, build it, and link the binary so it's available in your terminal.

git clone https://github.com/pglevy/mint.git
cd mint
npm install
npm run build
npm link

After linking, mint is available globally in your terminal sessions.

Once mint is published to npm, installation will be npm install -g @sailwind/mint (or as a dev dependency in sailwind-starter projects).

How to invoke

mint <command> [options]

Commands

List tokens

Show all tokens grouped by category, or filter by category:

mint list
mint list --category color
mint list --category typography
mint list --category spacing

Query tokens as JSON

Get structured DTCG JSON output, with optional category and family filters:

mint tokens
mint tokens --category color --family red
mint tokens --category spacing

Export tokens

Export the full token set or a filtered subset as DTCG JSON:

mint export
mint export --category color --out color-tokens.json

MCP schema

Output the MCP tool definition schema:

mint mcp-schema

Token categories

• color — Aurora color palette (red, orange, yellow, green, teal, sky, blue, purple, pink, gray) plus semantic colors (destructive, positive, accent, secondary, standard) and aliases (black)
• typography — Font family, font weight, and custom text sizes
• spacing — Custom spacing values, border radius, and SAIL margin size mappings

When to use

• When you need the exact hex value for a Sailwind color (e.g., "what's the hex for red-500?")
• When building a component and need to know available spacing or typography tokens
• When you need to understand semantic color mappings (e.g., which color is "destructive"?)
• When exporting tokens for consumption by other tools

JSON output

Add --json to any command for machine-readable output. The tokens and export commands always output JSON.