User Interface

Gokin uses the Bubble Tea TUI framework with 3 themes, a command palette, and streaming output.

Themes#

Switch via /theme <name> or the ui.theme config.

Dark (default)#

Deep dark background with soft accents.

Element	Color	Hex
Primary	Soft Purple	`#A78BFA`
Secondary	Bright Cyan	`#22D3EE`
Success	Soft Green	`#34D399`
Warning	Warm Amber	`#FBBF24`
Error	Soft Red	`#F87171`
Muted	Neutral Gray	`#9CA3AF`
Text	Soft White	`#F1F5F9`
Background	Deep Navy	`#0F172A`
Border	Subtle Slate	`#1E293B`
Accent	Pink	`#F472B6`
Info	Teal	`#2DD4BF`

macOS#

Apple-inspired theme in SF UI style.

Element	Color	Hex
Primary	SF Blue	`#007AFF`
Secondary	SF Purple	`#5856D6`
Success	SF Green	`#34C759`
Warning	SF Orange	`#FF9500`
Error	SF Red	`#FF3B30`
Text	White	`#FFFFFF`
Background	Dark Gray	`#1C1C1E`
Accent	SF Pink	`#FF2D55`
Info	SF Mint	`#00C7BE`

Light#

Light theme for daytime use.

Element	Color	Hex
Primary	Purple 600	`#7C3AED`
Secondary	Cyan 600	`#0891B2`
Success	Emerald 600	`#059669`
Warning	Amber 600	`#D97706`
Error	Red 600	`#DC2626`
Text	Slate 800	`#1E293B`
Background	Slate 50	`#F8FAFC`
Accent	Pink 600	`#DB2777`
Info	Teal 600	`#0D9488`

Icons#

Message Icons#

Icon	Meaning
✓	Success / Complete
✗	Error
⚠	Warning
ℹ	Information
›	Hint
◐	Loading
○	Waiting
●	Active
↷	Skipped

Tool Icons (Unicode, no emoji)#

Tool	Icon
read	▸
write	✦
edit	△
bash	$
glob	◇
grep	⊙
todo	☐
diff	±
tree	⊞
web_fetch / web_search	↗
list_dir	◇
ask_user	?
git_*	⎇
memory / memorize	◈
refactor	△
code_graph	◈
batch / task / test	▪
Default	·

Command Palette#

Opens via Ctrl+P.

Features:

All 35+ commands organized by category
Filter by name, description, and arguments
Shows unavailable commands with reason (no git repo, no API key)
Icons and usage hints

Select Mode#

Ctrl+G — freezes output and enables native text selection for copying.

Press Ctrl+G again to exit the mode.

Markdown Rendering#

Gokin renders Markdown in the terminal via the Glamour library:

Styled headers
Code blocks with syntax highlighting
Lists, tables, links
Inline code highlighting

Toggle:

ui:
  markdown_rendering: true

Streaming Output#

Model responses are rendered in real time as they’re generated:

ui:
  stream_output: true

Progress UI#

While agents work, progress is displayed:

Current step name
Completion percentage
Tokens used
Execution time

Mouse Mode#

Mouse support in TUI:

ui:
  mouse_mode: enabled    # enabled / disabled

Additional Settings#

ui:
  show_tool_calls: true        # Show tool calls
  show_token_usage: true       # Token statistics
  show_welcome: true           # Welcome on start
  hints_enabled: true          # Contextual hints
  compact_mode: false          # Compact mode
  bell: true                   # Terminal bell on prompts
  native_notifications: false  # macOS Notification Center