glyph. Components for the terminal.

Token palette every component reads from. Edit one file to retheme an entire app.

import "github.com/truffle-dev/glyph/components/theme"

t := theme.Default     // dark
t := theme.Light       // warm paper
fmt.Println(t.Primary) // lipgloss.Color

Role-aware speech bubble with width-aware wrapping. user / assistant / system / tool.

b := chatbubble.New(theme.Default).
  WithRole(chatbubble.RoleAssistant).
  WithLabel("glyph").
  WithText("Welcome.").
  WithWidth(72)
fmt.Println(b.View())

Single-line chat prompt with placeholder, cursor, focus state, submit and cancel bindings.

i := chatinput.New(theme.Default).
  WithPlaceholder("Type a message…").
  WithPrompt("you › ").
  WithWidth(72).
  Focus()

Vertically scrolling conversation surface. Composes chat-bubble. Arrow keys, PgUp/PgDn, Home/End.

t := chatthread.New(theme.Default).WithSize(72, 12)
t = t.Append(chatthread.Message{
  Role: chatbubble.RoleAssistant,
  Label: "glyph", Text: "Welcome.",
})

Filterable modal command picker. Substring matcher by default; swap in your own.

p := commandpalette.New(theme.Default).
  WithCommands([]commandpalette.Command{
    {ID: "save", Title: "Save file", Keybinding: "ctrl+s"},
  }).
  WithSize(72, 14)

Scrollable terminal markdown. Headings, paragraphs, bullets, blockquotes, code, links.

md := markdownviewer.New(theme.Default).
  WithSize(80, 18).
  WithSource(source)

Bounded color-coded log view that tails like tail -f. Level filter, capacity ring.

s := logstream.New(theme.Default).
  WithSize(96, 16).
  WithMinLevel(logstream.LevelInfo)
s = s.Append(logstream.Entry{
  Level: logstream.LevelWarn, Source: "auth",
  Message: "deprecated token format",
})

Unified-diff renderer with line numbers, color-coded additions and removals.

lines := diffview.ParseUnified(rawDiff)
d := diffview.New(theme.Default).
  WithSize(96, 18).
  WithLines(lines)

Stacked dismissible notifications with level-aware coloring and per-toast TTLs.

tray := notificationtoast.New(theme.Default).
  WithWidth(48).WithMaxItems(3)
tray = tray.Push(notificationtoast.Toast{
  ID: "build-1", Level: notificationtoast.LevelSuccess,
  Title: "Success", Message: "Build complete.",
  ExpiresAt: time.Now().Add(6 * time.Second),
})

Single-line three-segment status bar. Left fills from left, right anchors right, truncates left first under pressure.

bar := statusbar.New(theme.Default).
  WithWidth(80).
  WithLeft(statusbar.Item{Text: "glyph"}).
  WithCenter(statusbar.Item{Text: "main"}).
  WithRight(statusbar.Item{Text: "OK",
    Style: statusbar.StyleSuccess})

Animated single-glyph indicator with an optional label. Five styles: dots, line, arc, pulse, bounce. TickMsg carries an ID so a parent can multiplex several spinners.

s := spinner.New(theme.Default).
  WithStyle(spinner.StyleDots).
  WithLabel("Working")

Horizontal labeled tab row primitive. Arrow keys or Tab cycle with wrap. Parent owns the panels rendered below.

t := tabs.New(theme.Default).
  WithTabs([]string{"chat", "logs", "diff"}).
  WithActive(0)

Bordered container with optional title and footer. The workhorse layout primitive: wrap any view in one. Two border weights, configurable padding.

p := panel.New(theme.Default).
  WithTitle("Logs").
  WithFooter("3 entries").
  WithContent(logs.View())

Vertical selectable list with cursor highlight, optional hints, disabled items, and internal scrolling. The navigation primitive most agent UIs reach for after tabs.

l := list.New(theme.Default).
  WithHeight(8).
  WithItems([]list.Item{
    {Label: "Inbox", Hint: "12 unread"},
    {Label: "Drafts"},
  })

Determinate progress indicator with an optional label and percentage readout. Color- and glyph-tunable. Pair with spinner for indeterminate work.

bar := progressbar.New(theme.Default).
  WithPercent(0.42).
  WithLabel("uploading").
  WithWidth(40)

Compact footer of key-and-description pairs. The bottom-row cheatsheet every TUI grows into. Width-clamped so it never wraps mid-binding.

hints := keyhints.New(theme.Default).
  WithHints([]keyhints.Hint{
    {Key: "Tab", Desc: "next pane"},
    {Key: "q",   Desc: "quit"},
  })