Learn-skills.dev charmbracelet

Use this skill to build modern Go CLIs with the Charmbracelet stack. Default to Bubble Tea for any stateful TUI or interactive terminal flow, then layer in Bubbles, Huh, Lip Gloss, Wish, Glamour, and Log as needed.

Start Here

• Use

  charm.land/.../v2

  imports for the current v2 ecosystem.
• Treat Bubble Tea as the app runtime and state machine.
• Treat Bubbles as reusable widgets, not the app shell.
• Treat Lip Gloss as layout and styling.
• Treat Huh as the fastest way to build forms and wizards.
• Treat Glamour as markdown-to-ANSI rendering.
• Treat Log as diagnostics to

  stderr

  or files, not to the TUI surface.
• Treat Wish as the SSH transport layer for remote terminal apps.

When To Reach For Which Library

references/bubbletea-core.md

references/bubbletea-patterns.md

list

table

textinput

viewport

help

references/bubbles.md

references/huh.md

references/lipgloss.md

references/wish.md

references/glamour.md

references/log.md

references/api-surface.md

references/common-use-cases.md

references/troubleshooting-workarounds.md

references/examples.md

Default Build Strategy

1. Start with Bubble Tea when the user asks for a TUI, terminal UI, dashboard, picker, wizard, or interactive CLI.
2. Add Bubbles instead of rebuilding common widgets by hand.
3. Add Lip Gloss once layout or visual hierarchy matters.
4. Add Huh when the interaction is form-heavy.
5. Add Glamour when the app renders markdown content.
6. Add Log for diagnostics, background jobs, or server logs.
7. Add Wish only when the app should run over SSH.

Core Rules

• Keep business logic separate from the Bubble Tea model.
• Do I/O in

  tea.Cmd

  , not directly in

  Update

  or

  View

  .
• Handle resize with

  tea.WindowSizeMsg

  and keep layouts responsive.
• Request background color with

  tea.RequestBackgroundColor

  when styles depend on light/dark mode.
• In Bubble Tea v2, declare terminal behavior in

  tea.View

  fields like

  AltScreen

  and

  MouseMode

  .
• In standalone Lip Gloss or Glamour output, print with Lip Gloss writers so color downsampling works.
• In Wish apps, remember middleware runs in reverse declaration order.
• In Bubble Tea apps, write logs to

  stderr

  or a file, not to stdout.

Bubble Tea First Skeleton

package main

import tea "charm.land/bubbletea/v2"

type model struct{}

func (m model) Init() tea.Cmd {
    return nil
}

func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
    switch msg := msg.(type) {
    case tea.KeyPressMsg:
        switch msg.String() {
        case "q", "ctrl+c":
            return m, tea.Quit
        }
    }
    return m, nil
}

func (m model) View() tea.View {
    v := tea.NewView("Hello from Bubble Tea")
    return v
}

Read These Next

• Read

  references/bubbletea-core.md

  for Bubble Tea's model, commands, messages, and program lifecycle.
• Read

  references/bubbletea-patterns.md

  for app structure, async work, Cobra integration, and multi-model composition.
• Read

  references/troubleshooting-workarounds.md

  before migrating old Charmbracelet code or mixing stale examples with v2 code.