tui

Documentation

Index

• Constants
• Variables
• func ByGroup(cmds []Command) map[string][]Command
• func Groups() []string
• type AppState
• type Command
  • func Filter(query string) []Command
• type Model
  • func NewModel() *Model
  • func (m *Model) Accent() lipgloss.Style
  • func (m *Model) Init() tea.Cmd
  • func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd)
  • func (m *Model) View() string

Constants

const (
	GroupCode     = "Code"
	GroupGo       = "Go Tools"
	GroupPython   = "Python Tools"
	GroupSecurity = "Security"
	GroupSkills   = "Skills"
	GroupMCP      = "MCP & Serve"
	GroupSystem   = "System"
)

Group constants.

Variables

var Commands = []Command{

	{Key: "code", Title: "🚀 sin code", Description: "Unified coding workflow hub", Group: GroupCode},
	{Key: "code review", Title: "🔍 review", Description: "Semantic review of a change (IBD)", Group: GroupCode, Args: "<files>"},
	{Key: "code debt", Title: "🏚️  debt", Description: "Show current architectural debt", Group: GroupCode, Args: "<path>"},
	{Key: "code verify", Title: "✅ verify", Description: "Independent execution-based verification", Group: GroupCode, Args: "<target>"},
	{Key: "code preflight", Title: "✈️  preflight", Description: "Fresh GitNexus index for coder agents", Group: GroupCode},
	{Key: "code codocs", Title: "📚 codocs", Description: "Validate co-located .doc.md companions", Group: GroupCode, Args: "<path>"},
	{Key: "code sckg", Title: "🕸️  sckg", Description: "Semantic codebase knowledge graph", Group: GroupCode, Args: "<path>"},
	{Key: "code audit", Title: "🛡️  audit", Description: "47-gate CEO-audit (security/perf/quality)", Group: GroupCode, Args: "<path>"},
	{Key: "code full", Title: "⚡ full pipeline", Description: "preflight → codocs → debt → sckg → ...", Group: GroupCode, Args: "<path>"},

	{Key: "sin-code run discover", Title: "🗂️  discover", Description: "File discovery with relevance scoring", Group: GroupGo, Args: "<path>"},
	{Key: "sin-code run map", Title: "🗺️  map", Description: "Architecture map + dependency graph", Group: GroupGo, Args: "<path>"},
	{Key: "sin-code run grasp", Title: "🤖 grasp", Description: "Deep single-file analysis", Group: GroupGo, Args: "<file>"},
	{Key: "sin-code run scout", Title: "🔭 scout", Description: "Regex/semantic/symbol code search", Group: GroupGo, Args: "<query>"},
	{Key: "sin-code run harvest", Title: "🌾 harvest", Description: "URL fetch + cache + structure extract", Group: GroupGo, Args: "<url>"},
	{Key: "sin-code run execute", Title: "⚙️  execute", Description: "Safe exec with secret redaction", Group: GroupGo, Args: "<cmd>"},
	{Key: "sin-code run orchestrate", Title: "🪄 orchestrate", Description: "Task deps + parallel exec + rollback", Group: GroupGo},

	{Key: "ibd", Title: "🧬 ibd", Description: "Intent-Based Diffing (semantic AST)", Group: GroupPython, Args: "<files>"},
	{Key: "poc", Title: "📐 poc", Description: "Proof-of-Correctness verification", Group: GroupPython, Args: "<target>"},
	{Key: "adw", Title: "🏛️  adw", Description: "Architectural Debt Watchdog", Group: GroupPython, Args: "<path>"},
	{Key: "oracle", Title: "🔮 oracle", Description: "Independent Verification Oracle", Group: GroupPython, Args: "<target>"},
	{Key: "efm", Title: "🧪 efm", Description: "Ephemeral Full-Stack Mocking", Group: GroupPython, Args: "<spec>"},
	{Key: "sckg", Title: "🕸️  sckg", Description: "SCKG — knowledge graph (11 cmds)", Group: GroupPython, Args: "<cmd> [args]"},

	{Key: "security", Title: "🔐 security", Description: "8-tool security bundle (Snyk alt.)", Group: GroupSecurity, Args: "scan <path>"},

	{Key: "brain", Title: "🧠 brain", Description: "Global/project behavioral rules", Group: GroupSkills},
	{Key: "context-bridge", Title: "🌉 context-bridge", Description: "Unified SCKG+brain+gitnexus query", Group: GroupSkills, Args: "<query>"},
	{Key: "websearch", Title: "🔎 websearch", Description: "SerpAPI multi-key pool", Group: GroupSkills, Args: "<query>"},
	{Key: "scheduler", Title: "⏰ scheduler", Description: "Cron/interval job scheduling", Group: GroupSkills},
	{Key: "goal-mode", Title: "🎯 goal-mode", Description: "Goal tracking with checkpoints", Group: GroupSkills},
	{Key: "grill-me", Title: "🔥 grill-me", Description: "Adversarial design-review interview", Group: GroupSkills, Args: "<topic>"},
	{Key: "doc-coauthoring", Title: "📝 doc-coauthoring", Description: "Collaborative README/ADR/SPEC", Group: GroupSkills},
	{Key: "codocs", Title: "📘 codocs", Description: "CoDocs standard + sprint", Group: GroupSkills, Args: "<path>"},
	{Key: "marketplace", Title: "🛍️  marketplace", Description: "Skill catalog search/install", Group: GroupSkills},
	{Key: "browser", Title: "🌐 browser", Description: "106 browser-automation tools", Group: GroupSkills},

	{Key: "serve", Title: "📡 serve", Description: "Expose tools as unified MCP server", Group: GroupMCP},
	{Key: "serve-mcp", Title: "🛰️  serve-mcp", Description: "Start MCP server (stdio)", Group: GroupMCP},
	{Key: "mcp-config", Title: "📋 mcp-config", Description: "Generate ready-to-use MCP config", Group: GroupMCP},
	{Key: "simone", Title: "🔬 simone", Description: "Simone-MCP code analysis", Group: GroupMCP},

	{Key: "status", Title: "📊 status", Description: "Which subsystems are installed", Group: GroupSystem},
	{Key: "doctor", Title: "🩺 doctor", Description: "Diagnose environment + audit chain", Group: GroupSystem},
	{Key: "bootstrap", Title: "🎬 bootstrap", Description: "Initialize subsystems for repo", Group: GroupSystem, Args: "<path>"},
	{Key: "agents-md", Title: "🤝 agents-md", Description: "Create/update AGENTS.md", Group: GroupSystem},
	{Key: "policy", Title: "📜 policy", Description: "Inspect/init SIN policy + audit log", Group: GroupSystem},
	{Key: "skills", Title: "🎓 skills", Description: "Compile portable skills to agent fmt", Group: GroupSystem},
	{Key: "update", Title: "⬆️  update", Description: "Self-update stack (pipx + Go)", Group: GroupSystem},
	{Key: "config", Title: "⚙️  config", Description: "Unified config management", Group: GroupSystem},
}

Commands is the full menu catalog. Order within a group = display order.

Functions

func ByGroup

func ByGroup(cmds []Command) map[string][]Command

ByGroup groups commands by their Group field, preserving catalog order.

func Groups

func Groups() []string

Groups returns the menu groups in display order.

Types

type AppState

type AppState int

AppState — the finite-state machine of the TUI.

const (
	StateMenu    AppState = iota // user is browsing the menu
	StateSearch                  // user is typing in the search bar
	StatePrompt                  // user is providing Args value
	StateRunning                 // a command is currently executing
	StateOutput                  // command finished; showing output
)

type Command

type Command struct {
	// Key is the canonical subcommand name, e.g. "sckg", "code", "doctor".
	Key string
	// Title is shown in the menu, supports emojis and short labels.
	Title string
	// Description is a one-line explanation shown beside the menu item.
	Description string
	// Group classifies the command in the menu (Code, Skills, MCP, ...).
	Group string
	// Args is the raw argument template. If non-empty, the TUI prompts for
	// a value before running. The placeholder is rendered as the prompt hint.
	Args string
	// Danger marks destructive commands (e.g. "policy reset") for red styling.
	Danger bool
}

Command describes one callable sin subcommand exposed in the TUI menu.

func Filter

func Filter(query string) []Command

Filter returns the commands matching the current query (case-insensitive substring match on key, title, or description).

type Model

type Model struct {
	// contains filtered or unexported fields
}

Model is the Bubbletea top-level model.

func NewModel

func NewModel() *Model

NewModel builds a fresh TUI model.

func (*Model) Accent

func (m *Model) Accent() lipgloss.Style

makeAccent returns a style for an inline accent (workaround helper).

func (*Model) Init

func (m *Model) Init() tea.Cmd

Init starts the spinner.

func (*Model) Update

func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd)

func (*Model) View

func (m *Model) View() string