ui

package
v0.62.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 13, 2026 License: MIT Imports: 8 Imported by: 0

Documentation

Overview

Package ui provides terminal styling for beads CLI output.

Package ui provides terminal styling and pager support for beads CLI output.

Package ui provides terminal styling for beads CLI output. Uses the Ayu color theme with adaptive light/dark mode support.

Package ui provides terminal styling and output helpers for beads CLI.

Index

Constants

View Source 
const (
	IconPass = "✓"
	IconWarn = "⚠"
	IconFail = "✖"
	IconSkip = "-"
	IconInfo = "ℹ"
)

Status icons - consistent semantic indicators

View Source 
const (
	StatusIconOpen       = "○" // available to work (hollow circle)
	StatusIconInProgress = "◐" // active work (half-filled)
	StatusIconBlocked    = "●" // needs attention (filled circle)
	StatusIconClosed     = "✓" // completed (checkmark)
	StatusIconDeferred   = "❄" // scheduled for later (snowflake)
	StatusIconPinned     = "📌" // elevated priority
)

Issue status icons - used consistently across all commands Design principle: icons > text labels for scannability IMPORTANT: Use small Unicode symbols, NOT emoji-style icons (🔴🟠 etc.) Emoji blobs cause cognitive overload and break visual consistency

View Source 
const (
	TreeChild  = "⎿ "  // child indicator
	TreeLast   = "└─ " // last child / detail line
	TreeIndent = "  "  // 2-space indent per level
)

Tree characters for hierarchical display

View Source 
const (
	SeparatorLight = "" /* 126-byte string literal not displayed */
	SeparatorHeavy = "" /* 126-byte string literal not displayed */
)

Separators

View Source 
const PriorityIcon = "●"

Priority icon - small filled circle, colored by priority level IMPORTANT: Use this small circle, NOT emoji blobs (🔴🟠🟡🔵⚪)

Variables

View Source 
var (
	// Core semantic colors (Ayu theme - adaptive light/dark)
	ColorPass = lipgloss.AdaptiveColor{
		Light: "#86b300",
		Dark:  "#c2d94c",
	}
	ColorWarn = lipgloss.AdaptiveColor{
		Light: "#f2ae49",
		Dark:  "#ffb454",
	}
	ColorFail = lipgloss.AdaptiveColor{
		Light: "#f07171",
		Dark:  "#f07178",
	}
	ColorMuted = lipgloss.AdaptiveColor{
		Light: "#828c99",
		Dark:  "#6c7680",
	}
	ColorAccent = lipgloss.AdaptiveColor{
		Light: "#399ee6",
		Dark:  "#59c2ff",
	}

	// === Workflow Status Colors ===
	// Only actionable states get color - open/closed match standard text
	ColorStatusOpen = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}
	ColorStatusInProgress = lipgloss.AdaptiveColor{
		Light: "#f2ae49",
		Dark:  "#ffb454",
	}
	ColorStatusClosed = lipgloss.AdaptiveColor{
		Light: "#9099a1",
		Dark:  "#8090a0",
	}
	ColorStatusBlocked = lipgloss.AdaptiveColor{
		Light: "#f07171",
		Dark:  "#f26d78",
	}
	ColorStatusPinned = lipgloss.AdaptiveColor{
		Light: "#d2a6ff",
		Dark:  "#d2a6ff",
	}
	ColorStatusHooked = lipgloss.AdaptiveColor{
		Light: "#59c2ff",
		Dark:  "#59c2ff",
	}

	// === Priority Colors ===
	// Only P0/P1 get color - they need attention
	// P2/P3/P4 are neutral (medium/low/backlog don't need visual urgency)
	ColorPriorityP0 = lipgloss.AdaptiveColor{
		Light: "#f07171",
		Dark:  "#f07178",
	}
	ColorPriorityP1 = lipgloss.AdaptiveColor{
		Light: "#ff8f40",
		Dark:  "#ff8f40",
	}
	ColorPriorityP2 = lipgloss.AdaptiveColor{
		Light: "#e6b450",
		Dark:  "#e6b450",
	}
	ColorPriorityP3 = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}
	ColorPriorityP4 = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}

	// === Issue Type Colors ===
	// Bugs and epics get color - they need attention
	// All other types use standard text
	ColorTypeBug = lipgloss.AdaptiveColor{
		Light: "#f07171",
		Dark:  "#f26d78",
	}
	ColorTypeFeature = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}
	ColorTypeTask = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}
	ColorTypeEpic = lipgloss.AdaptiveColor{
		Light: "#d2a6ff",
		Dark:  "#d2a6ff",
	}
	ColorTypeChore = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}

	// === Issue ID Color ===
	// IDs use standard text color - subtle, not attention-grabbing
	ColorID = lipgloss.AdaptiveColor{
		Light: "",
		Dark:  "",
	}
)

Ayu theme color palette Dark: https://terminalcolors.com/themes/ayu/dark/ Light: https://terminalcolors.com/themes/ayu/light/ Source: https://github.com/ayu-theme/ayu-colors

View Source 
var (
	PassStyle   = lipgloss.NewStyle().Foreground(ColorPass)
	WarnStyle   = lipgloss.NewStyle().Foreground(ColorWarn)
	FailStyle   = lipgloss.NewStyle().Foreground(ColorFail)
	MutedStyle  = lipgloss.NewStyle().Foreground(ColorMuted)
	AccentStyle = lipgloss.NewStyle().Foreground(ColorAccent)
)

Core styles - consistent across all commands

View Source 
var (
	StatusOpenStyle       = lipgloss.NewStyle().Foreground(ColorStatusOpen)
	StatusInProgressStyle = lipgloss.NewStyle().Foreground(ColorStatusInProgress)
	StatusClosedStyle     = lipgloss.NewStyle().Foreground(ColorStatusClosed)
	StatusBlockedStyle    = lipgloss.NewStyle().Foreground(ColorStatusBlocked)
	StatusPinnedStyle     = lipgloss.NewStyle().Foreground(ColorStatusPinned)
	StatusHookedStyle     = lipgloss.NewStyle().Foreground(ColorStatusHooked)
)

Status styles for workflow states

View Source 
var (
	PriorityP0Style = lipgloss.NewStyle().Foreground(ColorPriorityP0).Bold(true)
	PriorityP1Style = lipgloss.NewStyle().Foreground(ColorPriorityP1)
	PriorityP2Style = lipgloss.NewStyle().Foreground(ColorPriorityP2)
	PriorityP3Style = lipgloss.NewStyle().Foreground(ColorPriorityP3)
	PriorityP4Style = lipgloss.NewStyle().Foreground(ColorPriorityP4)
)

Priority styles

View Source 
var (
	TypeBugStyle     = lipgloss.NewStyle().Foreground(ColorTypeBug)
	TypeFeatureStyle = lipgloss.NewStyle().Foreground(ColorTypeFeature)
	TypeTaskStyle    = lipgloss.NewStyle().Foreground(ColorTypeTask)
	TypeEpicStyle    = lipgloss.NewStyle().Foreground(ColorTypeEpic)
	TypeChoreStyle   = lipgloss.NewStyle().Foreground(ColorTypeChore)
)

Type styles for issue categories

View Source 
var BoldStyle = lipgloss.NewStyle().Bold(true)

BoldStyle for emphasis

View Source 
var CategoryStyle = lipgloss.NewStyle().Bold(true).Foreground(ColorAccent)

CategoryStyle for section headers - bold with accent color

View Source 
var CommandStyle = lipgloss.NewStyle().Foreground(lipgloss.AdaptiveColor{
	Light: "#5c6166",
	Dark:  "#bfbdb6",
})

CommandStyle for command names - subtle contrast, not attention-grabbing

View Source 
var IDStyle = lipgloss.NewStyle().Foreground(ColorID)

Issue ID style

Functions

func GetStatusIcon 

func GetStatusIcon(status string) string

GetStatusIcon returns just the icon character without styling Useful when you need to apply custom styling or for non-TTY output

func GetStatusStyle 

func GetStatusStyle(status string) lipgloss.Style

GetStatusStyle returns the lipgloss style for a given status Use this when you need to apply the semantic color to custom text Example: ui.GetStatusStyle("in_progress").Render(myCustomText)

func IsAgentMode 

func IsAgentMode() bool

IsAgentMode returns true if the CLI is running in agent-optimized mode. This is triggered by:

  • BD_AGENT_MODE=1 environment variable (explicit)
  • CLAUDE_CODE environment variable (auto-detect Claude Code)

Agent mode provides ultra-compact output optimized for LLM context windows.

func IsTerminal 

func IsTerminal() bool

IsTerminal returns true if stdout is connected to a terminal (TTY).

func RenderAccent 

func RenderAccent(s string) string

RenderAccent renders text with accent (blue) styling

func RenderBold 

func RenderBold(s string) string

RenderBold renders text in bold

func RenderCategory 

func RenderCategory(s string) string

RenderCategory renders a category header in uppercase with accent color

func RenderClosedLine 

func RenderClosedLine(line string) string

RenderClosedLine renders an entire line in the closed/dimmed style

func RenderCommand 

func RenderCommand(s string) string

RenderCommand renders a command name with subtle styling

func RenderFail 

func RenderFail(s string) string

RenderFail renders text with fail (red) styling

func RenderFailIcon 

func RenderFailIcon() string

RenderFailIcon renders the fail icon with styling

func RenderID 

func RenderID(id string) string

RenderID renders an issue ID with semantic styling

func RenderInfoIcon 

func RenderInfoIcon() string

RenderInfoIcon renders the info icon with styling

func RenderIssueCompact 

func RenderIssueCompact(id string, priority int, issueType, status, title string) string

RenderIssueCompact renders a compact one-line issue summary Format: ID [Priority] [Type] Status - Title When status is "closed", the entire line is dimmed to show it's done

func RenderMarkdown 

func RenderMarkdown(markdown string) string

RenderMarkdown renders markdown text using glamour with beads theme colors. Returns the rendered markdown or the original text if rendering fails. Word wraps at terminal width (or 80 columns if width can't be detected).

func RenderMuted 

func RenderMuted(s string) string

RenderMuted renders text with muted (gray) styling

func RenderPass 

func RenderPass(s string) string

RenderPass renders text with pass (green) styling

func RenderPassIcon 

func RenderPassIcon() string

RenderPassIcon renders the pass icon with styling

func RenderPriority 

func RenderPriority(priority int) string

RenderPriority renders a priority level with semantic styling Format: ● P0 (icon + label) P0/P1 get color; P2/P3/P4 use standard text

func RenderPriorityCompact 

func RenderPriorityCompact(priority int) string

RenderPriorityCompact renders just the priority label without icon Use when space is constrained or icon would be redundant

func RenderPriorityForStatus 

func RenderPriorityForStatus(priority int, status string) string

RenderPriorityForStatus renders priority with color only if not closed

func RenderSeparator 

func RenderSeparator() string

RenderSeparator renders the light separator line in muted color

func RenderSkipIcon 

func RenderSkipIcon() string

RenderSkipIcon renders the skip icon with styling

func RenderStatus 

func RenderStatus(status string) string

RenderStatus renders a status with semantic styling in_progress/blocked/pinned get color; open/closed use standard text

func RenderStatusIcon 

func RenderStatusIcon(status string) string

RenderStatusIcon returns the appropriate icon for a status with semantic coloring This is the canonical source for status icon rendering - use this everywhere

func RenderType 

func RenderType(issueType string) string

RenderType renders an issue type with semantic styling bugs and epics get color; all other types use standard text Note: Gas Town-specific types (agent, role, rig) now fall through to default

func RenderTypeForStatus 

func RenderTypeForStatus(issueType, status string) string

RenderTypeForStatus renders type with color only if not closed

func RenderWarn 

func RenderWarn(s string) string

RenderWarn renders text with warning (yellow) styling

func RenderWarnIcon 

func RenderWarnIcon() string

RenderWarnIcon renders the warning icon with styling

func ShouldUseColor 

func ShouldUseColor() bool

ShouldUseColor determines if ANSI color codes should be used. Respects standard conventions:

  • BD_GIT_HOOK=1: disables color in git hook context (prevents OSC 11 queries, GH#1303)
  • NO_COLOR: https://no-color.org/ - disables color if set
  • CLICOLOR=0: disables color
  • CLICOLOR_FORCE: forces color even in non-TTY
  • Falls back to TTY detection

func ShouldUseEmoji 

func ShouldUseEmoji() bool

ShouldUseEmoji determines if emoji decorations should be used. Disabled in non-TTY mode to keep output machine-readable. Can be controlled with BD_NO_EMOJI environment variable.

func ToPager 

func ToPager(content string, opts PagerOptions) error

ToPager pipes content to a pager if appropriate. If pager should not be used (not a TTY, --no-pager, etc.), prints directly. If content fits in terminal, prints directly without pager.

Types

type PagerOptions 

type PagerOptions struct {
	// NoPager disables pager for this command (--no-pager flag)
	NoPager bool
}

PagerOptions controls pager behavior

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.