charmtone

name

charmtone

description

Use charmtone colors via the `charmtone` CLI or Go API (`github.com/charmbracelet/x/exp/charmtone`). Triggers when the user asks to use charmtone colors, generate color palettes, get hex values, create CSS/SCSS/Vim color variables, or work with the CharmTone palette in Go code. Also triggers on mentions of specific charmtone color names (Cherry, Charple, Julep, Hazy, etc.) or requests to pick/choose/apply charmtone colors.

CharmTone

Use CharmTone colors via the CLI or Go API. The complete palette is listed below — refer to it directly rather than guessing hex values.

CLI

The charmtone CLI renders the full palette and generates color variables.

# Show full palette in terminal (with color blocks)
charmtone

# Generate CSS custom properties
charmtone css > colors.css
# Output: --charmtone-cherry: #FF388B; --charmtone-charple: #6B50FF; ...

# Generate SCSS variables
charmtone scss > colors.scss
# Output: $cherry: #FF388B; $charple: #6B50FF; ...

# Generate Vim let variables
charmtone vim > charmtone.vim
# Output: let cherry = '#FF388B' | let charple = '#6B50FF' | ...

The CLI is ideal for generating static color files or quickly looking up hex values. It does not accept color name arguments — it always outputs the full palette.

Go API

Import: github.com/charmbracelet/x/exp/charmtone

import "github.com/charmbracelet/x/exp/charmtone"

// Color constants
c := charmtone.Cherry
fmt.Println(c.Hex())    // "#FF388B"
fmt.Println(c.String()) // "Cherry"
r, g, b, a := c.RGBA()  // 16-bit RGBA

// Key satisfies color.Color
var _ color.Color = charmtone.Charple

// Palette groups
charmtone.Spectrum()   // Cumin through Zest (47 colors)
charmtone.Neutrals()   // Pepper through Soda (12 colors)
charmtone.Charples()   // Jelly → Darple → Charple → Larple → Hazy (5)
charmtone.Additions()  // Spinach → Gator → Pickle → Julep (4)
charmtone.Deletions()  // Toast → Steak → Pom → Cherry (4)
charmtone.Keys()       // All colors (~72)

// Type checks on Key
charmtone.Julep.IsPrimary()    // true
charmtone.Coral.IsSecondary()  // true
charmtone.Pepper.IsNeutral()   // true
charmtone.Darple.IsCharple()   // true
charmtone.Chili.IsSpectrum()   // true

See references/go-api.md for full method signatures and grouping details.

Complete Color Palette

All 68 CharmTone colors, grouped by palette.

Spectrum (47 colors, Cumin → Zest)

Color	Hex	Color	Hex	Color	Hex
Cumin	#BF976F	Tang	#FF985A	Yam	#FFB587
Paprika	#D36C64	Bengal	#FF6E63	Uni	#FF937D
Sriracha	#EB4268	Coral	#FF577D	Salmon	#FF7F90
Chili	#E23080	Cherry	#FF388B	Tuna	#FF6DAA
Macaron	#E940B0	Pony	#FF4FBF	Cheeky	#FF79D0
Flamingo	#F947E3	Dolly	#FF60FF	Blush	#FF84FF
Urchin	#C337E0	Mochi	#EB5DFF	Lilac	#F379FF
Prince	#9C35E1	Violet	#C259FF	Mauve	#D46EFF
Grape	#7134DD	Plum	#9953FF	Orchid	#AD6EFF
Jelly	#4A30D9	Charple	#6B50FF	Hazy	#8B75FF
Ox	#3331B2	Sapphire	#4949FF	Guppy	#7272FF
Oceania	#2B55B3	Thunder	#4776FF	Anchovy	#719AFC
Damson	#007AB8	Malibu	#00A4FF	Sardine	#4FBEFE
Zinc	#10B1AE	Turtle	#0ADCD9	Lichen	#5CDFEA
Guac	#12C78F	Julep	#00FFB2	Bok	#68FFD6
Mustard	#F5EF34	Citron	#E8FF27	Zest	#E8FE96

Butter

Color	Hex
Butter	#FFFAF1

Neutrals (12 colors, Pepper → Soda)

Color	Hex	Color	Hex	Color	Hex
Pepper	#201F26	BBQ	#2D2C36	Char	#3A3943
Iron	#4D4C57	Oyster	#605F6B	Squid	#858392
Steam	#A2A0AD	Smoke	#BFBCC8	Steep	#D6D3DC
Sash	#ECEBF0	Salt	#F7F6FB	Soda	#FBFBFB

Charples (5 colors: Jelly → Darple → Charple → Larple → Hazy)

Color	Hex
Jelly	#4A30D9
Darple	#5B40EC
Charple	#6B50FF
Larple	#7B62FF
Hazy	#8B75FF

Diff Additions (Spinach → Gator → Pickle → Julep)

Color	Hex
Spinach	#1C3634
Gator	#18463D
Pickle	#00A475
Julep	#00FFB2

Diff Deletions (Toast → Steak → Pom → Cherry)

Color	Hex
Toast	#412130
Steak	#582238
Pom	#AB2454
Cherry	#FF388B

Secondary extras

Color	Hex
Ice	#00FFFC

Deprecated aliases

Alias	Renamed to
Charcoal	Char
Ash	Sash

Palette Membership

Group	Count	Colors
Primary	8	Charple, Dolly, Julep, Zest, Hazy, Blush, Bok, Butter
Secondary	7	Uni, Coral, Tuna, Violet, Malibu, Turtle, Ice
Spectrum	47	Cumin through Zest
Neutrals	12	Pepper through Soda
Charples	5	Jelly, Darple, Charple, Larple, Hazy
Additions	4	Spinach, Gator, Pickle, Julep
Deletions	4	Toast, Steak, Pom, Cherry

Primary colors are marked with ● in the CLI output, secondary with ○.