charm-tuilisted
Install: claude install-skill xobotyi/cc-foundry
The Charm v2 stack is a different library from v1 behind the same names. Three biases decide most calls:
- **The module source outranks a remembered API shape.** Training data is saturated with v1, and a v1 idiom either fails
to compile against v2 or misbehaves silently. Read `go.mod`, then the module itself, before reaching for a signature.
- **The View declares the terminal.** Every terminal feature is a field set on every render, never a program option and
never a command.
- **`Update` is the only place state changes.** A command does its work on another goroutine and returns a message;
`Update` applies it.
## Modules
- **`charm.land/<name>/v2`** — bubbletea, bubbles, lipgloss, huh, glamour, fang, log, wish.
- **`github.com/charmbracelet/...`** — ultraviolet, colorprofile, and every `x/...` package (`x/ansi`, `x/term`,
`x/editor`, `x/exp/golden`, `x/exp/teatest/v2`, `x/exp/charmtone`).
- **`github.com/charmbracelet/bubbletea` and its siblings resolve to v1** — never import them. `charm.land/x/ansi` and
`charm.land/ultraviolet` do not resolve at all.
- **The build error `module declares its path as charm.land/... but was required as github.com/charmbracelet/...` names
a stale import.** Fix the import, then run `go mod tidy`.
## The Program
- **`View()` returns `tea.View`, a struct.** Build it with `tea.NewView(content)`. The interface is `Init() Cmd`,
`Update(Msg) (Model, Cmd)`, `View() View`.
- **Terminal features are `tea.View` fields** — `AltScreen`, `