Terminal Stylist: Console Output Analysis Report

[github-actions[bot]]

Overview

Analyzed 579 non-test Go source files across pkg/ for console output consistency, Lipgloss styling patterns, and Huh form usage. The codebase has a well-architected, centralized console formatting system and makes excellent use of the Charmbracelet ecosystem. A focused set of files still use raw fmt.Fprintf(os.Stderr, ...) without console formatters, creating minor visual inconsistencies.

Overall score: 9/10 — excellent foundation with a clear, actionable improvement area.

---

Summary

Category	Status	Details
Lipgloss usage	✅ Excellent	578+ lines in console package; adaptive colors (light/dark) throughout
Huh forms	✅ Excellent	12 files, all interactive prompts covered
Console formatter coverage	✅ Strong	1,248 usages across codebase
Stderr vs stdout separation	✅ Correct	Data → stdout, diagnostics → stderr
Raw ANSI sequences	✅ All justified	logger (DEBUG) and terminal control only
Unformatted stderr messages	⚠️ Moderate	~54 files with raw fmt.Fprintf(os.Stderr, ...)

---

Charmbracelet Ecosystem Integration

Lipgloss — Adaptive Color System

The pkg/styles/theme.go file implements a comprehensive adaptive color palette using lipgloss.AdaptiveColor, automatically choosing between light- and dark-mode variants:

ColorError   = lipgloss.AdaptiveColor{Light: "#D73737", Dark: "#FF5555"}   // Red
ColorWarning = lipgloss.AdaptiveColor{Light: "#E67E22", Dark: "#FFB86C"}   // Orange
ColorSuccess = lipgloss.AdaptiveColor{Light: "#27AE60", Dark: "#50FA7B"}   // Green
ColorInfo    = lipgloss.AdaptiveColor{Light: "#2980B9", Dark: "#8BE9FD"}   // Cyan
ColorPurple  = lipgloss.AdaptiveColor{...}  // File paths, commands
ColorYellow  = lipgloss.AdaptiveColor{...}  // Progress, attention

Dark theme is Dracula-inspired; light theme uses higher-contrast, saturated variants. All styling is gated behind TTY detection via applyStyle().

The console package exposes a rich rendering API built on Lipgloss:

• RenderTable(TableConfig) — lipgloss/table with alternating rows, headers, totals
• RenderTitleBox(title, width) — double border, centered, bold
• RenderErrorBox(title) — rounded border in error color
• RenderInfoSection(content) — left border in info color
• RenderComposedSections([]string) — lipgloss.JoinVertical

Usage stats: 17 × console.RenderTable, 2 × RenderTitleBox, 3 × RenderErrorBox, 4 × RenderInfoSection

Huh — Interactive Forms

Huh v0.8.0 is properly integrated for all interactive user input across 12 files:

File	Form Types Used
pkg/console/confirm.go	NewConfirm
pkg/console/input.go	NewInput with EchoModePassword
pkg/cli/run_interactive.go	NewSelect, NewInput, NewConfirm
pkg/cli/add_interactive_engine.go	NewSelect
pkg/cli/add_interactive_schedule.go	NewSelect
pkg/cli/add_interactive_auth.go	NewInput
pkg/cli/add_interactive_orchestrator.go	NewConfirm
pkg/cli/add_interactive_git.go	Forms
pkg/cli/add_interactive_workflow.go	Forms
pkg/cli/engine_secrets.go	Forms
pkg/cli/interactive.go	Forms

Accessibility: All forms call .WithAccessible(console.IsAccessibleMode()). The IsAccessibleMode() function correctly checks ACCESSIBLE, TERM=dumb, and NO_COLOR environment variables.

No plain fmt.Scan* or bufio.Scanner prompts were found — all interactive input goes through Huh. ✅

---

Console Formatter Usage

Function usage breakdown (1,248 total calls)

Function	Calls	Notes
console.FormatInfoMessage	535	Most-used — heavily adopted
console.FormatWarningMessage	374	Strong adoption
console.FormatSuccessMessage	183	Good coverage
console.FormatVerboseMessage	65	Debug-level messages
console.FormatErrorMessage	58	Error messages
console.FormatSectionHeader	24	Section headers
console.RenderTable	17	Structured tabular data
console.FormatCommandMessage	20	Command display
console.FormatFileSize	14	File size formatting
console.FormatProgressMessage	11	Progress indication
console.FormatErrorWithSuggestions	10	Errors with hints
console.RenderStruct	9	Struct rendering
Other (FormatListItem, RenderErrorBox, etc.)	28	Specialized cases

---

Issues: Unformatted stderr Output

~54 files write directly to os.Stderr without console formatters. All diagnostic messages—not data output—should use the appropriate console.Format* wrapper for visual consistency.

Priority files to fix

pkg/cli/copilot_setup.go — 12 raw stderr calls

// Current:
fmt.Fprintf(os.Stderr, "No version upgrade needed for %s\n", setupStepsPath)
fmt.Fprintf(os.Stderr, "Updated %s with new version %s\n", setupStepsPath, version)
fmt.Fprintf(os.Stderr, "Skipping %s (already has gh-aw extension install step)\n", path)

// Improved:
fmt.Fprintln(os.Stderr, console.FormatInfoMessage(fmt.Sprintf("No version upgrade needed for %s", setupStepsPath)))
fmt.Fprintln(os.Stderr, console.FormatSuccessMessage(fmt.Sprintf("Updated %s with new version %s", setupStepsPath, version)))
fmt.Fprintln(os.Stderr, console.FormatInfoMessage(fmt.Sprintf("Skipping %s (already has gh-aw extension install step)", path)))

pkg/cli/mcp_list_tools.go — 4 raw stderr calls

// Current:
fmt.Fprintf(os.Stderr, "Available MCP servers: ")
fmt.Fprintf(os.Stderr, "%s\n", strings.Join(serverNames, ", "))
fmt.Fprintf(os.Stderr, "Found MCP server '%s' in %d workflow(s): %s\n", ...)
fmt.Fprintf(os.Stderr, "\nRun 'gh aw mcp list-tools %s (workflow-name)'...\n", ...)

// Improved:
fmt.Fprintln(os.Stderr, console.FormatInfoMessage("Available MCP servers: "+strings.Join(serverNames, ", ")))
fmt.Fprintln(os.Stderr, console.FormatSuccessMessage(fmt.Sprintf("Found MCP server '%s' in %d workflow(s): %s", ...)))
fmt.Fprintln(os.Stderr, console.FormatInfoMessage(fmt.Sprintf("Run 'gh aw mcp list-tools %s (workflow-name)'...", ...)))

pkg/cli/gateway_logs.go — Manual ASCII table rendering (20+ lines)

This file builds tables manually using Unicode box-drawing characters and fmt.Fprintf column alignment. The output is written to a strings.Builder (not directly to stderr), then likely displayed later. This is a candidate for console.RenderTable(TableConfig{...}) if the output is user-facing, or can remain as-is if it's a formatted data export.

Files with raw stderr (complete list, 54 files)

actionlint.go, add_command.go, add_interactive_auth.go, add_interactive_engine.go, add_interactive_git.go, add_interactive_orchestrator.go, add_interactive_schedule.go, add_interactive_secrets.go, add_interactive_workflow.go, audit.go, audit_report_render.go, compile_helpers.go, compile_stats.go, compile_watch.go, copilot_agents.go, copilot_setup.go, deps_outdated.go, deps_report.go, deps_security.go, devcontainer.go, domains_command.go, enable.go, engine_secrets.go, fix_command.go, gateway_logs.go, health_command.go, init.go, interactive.go, list_workflows_command.go, logs_orchestrator.go, logs_report.go, mcp_config_file.go, mcp_inspect.go, mcp_inspect_inspector.go, mcp_inspect_list.go, mcp_inspect_mcp.go, mcp_list.go, mcp_list_tools.go, pr_command.go, preconditions.go, remove_command.go, run_interactive.go, run_push.go, run_workflow_execution.go, secret_set_command.go, shell_completion.go, tokens_bootstrap.go, trial_command.go, trial_repository.go, update_actions.go, update_check.go, update_display.go, upgrade_command.go, vscode_config.go

Note: many of these files also use console formatters correctly for some messages — the issue is partial, not total, non-compliance.

---

Justified Patterns (No Action Needed)

Pattern	Location	Reason
Raw ANSI 256-color codes	pkg/logger/logger.go	DEBUG-only output; namespace coloring
Terminal control sequences	pkg/console/terminal.go	ClearScreen()/ClearLine() require raw ANSI
ANSI parsing	pkg/stringutil/ansi.go	Utility code, not output
fmt.Println(jsonBytes) to stdout	health_command.go, status_command.go, etc.	Structured data for pipe/redirect
fmt.Println(hash) to stdout	hash_command.go	Hash is the command output
fmt.Println(mermaidGraph) to stdout	tool_graph.go	Graph data for pipe/redirect

---

Recommendations

🟡 Medium — Wrap unformatted os.Stderr writes (54 files)

Replace bare fmt.Fprintf(os.Stderr, "message\n") with fmt.Fprintln(os.Stderr, console.FormatInfoMessage("message")) (or the appropriate formatter). Focus first on user-visible commands: copilot setup, mcp list-tools, and gateway_logs.

🟢 Low — gateway_logs.go manual table → console.RenderTable

The manual Unicode box-drawing table (~40 lines) in gateway_logs.go could be replaced with console.RenderTable(TableConfig{...}) to gain adaptive colors, TTY-aware rendering, and consistent border styling.

🟢 Low — FormatListItem and FormatPromptMessage underused

FormatListItem (used only 2× in cli/) and FormatPromptMessage (used 1×) are available but underutilized. Audit spots with fmt.Fprintf(os.Stderr, " - %s\n", item) and fmt.Fprintf(os.Stderr, "\nSelect ...\n") patterns.

---

References:

• §23120675404

AI generated by Terminal Stylist · history

• expires on Mar 16, 2026, 10:28 PM UTC

[pelikhan]

/plan

[github-actions[bot]]

This discussion has been marked as outdated by Terminal Stylist.

A newer discussion is available at Discussion #21292.