Color CLI

Convert colors accurately between hex, rgb, and oklch using

@kood/color-cli

.

@kood/color-cli

Positive triggers

• "Convert #ff0000 to oklch"
• "What's the oklch value of rgb(0, 128, 255)?"
• "Convert all colors in styles.css to oklch"
• "hex to rgb", "oklch to hex", "convert this color"
• "Normalize the colors in this CSS file to hex"

Out-of-scope

• Color palette generation or design suggestions — use a design skill instead.
• Color theory explanations — answer directly without this skill.
• Creating CSS from scratch — use an implementation skill instead.

Boundary

• "What color is oklch(0.7 0.25 140)?" → Use this skill to get the hex/rgb equivalent.
• "Pick a good color for a button" → Do not use this skill; this is a design question.

@kood/color-cli

npm i -g @kood/color-cli

color --help

color

Single Color Conversion

color "<value>"

color "#ff0000"
color "oklch(0.7 0.25 140)"
color "rgb(255, 0, 0)"
color "hsl(0, 100%, 50%)"

color --json "#ff0000"

color "#e63946" "oklch(0.7 0.25 140)" "rgb(0, 128, 255)"

CSS File Color Conversion

color css <file> --to <format> --dry-run

color css <file> --to <format>

hex

rgb

oklch

# Preview oklch conversion
color css styles.css --to oklch --dry-run

# Apply hex conversion
color css src/global.css --to hex

# Convert to rgb
color css theme.css --to rgb

CSS conversion behavior

• Automatically detects hex, rgb, rgba, oklch patterns in the file
• Skips colors already in the target format
• Preserves alpha values (e.g.,

  rgba(255,0,0,0.5)

  →

  oklch(0.628 0.258 29.23 / 0.5)

  )
• Ignores colors inside CSS comments (

  /* ... */

  )
• Applies CSS Color Level 4 gamut mapping for out-of-gamut oklch values

Single color output

HEX:   #ff0000
RGB:   rgb(255, 0, 0)
OKLCH: oklch(0.6280 0.2577 29.23)

Gamut mapping warning

⚠ Color was outside sRGB gamut — CSS Color Level 4 chroma-reduction applied.

CSS conversion summary

styles.css: 12 colors found, 8 converted, 4 skipped

• converted: colors that were changed to the target format
• skipped: colors already in the target format

• Always use

  --dry-run

  first when converting CSS files, then apply if the user confirms.
• When the user provides an oklch value, always run the conversion rather than computing manually — AI models frequently produce incorrect oklch ↔ hex mappings.
• Report the full output (hex, rgb, oklch) to the user so they can pick the format they need.
• For CSS file operations, show the summary (converted/skipped counts) to the user.