| 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.
