leantui

Documentation

Overview

Package leantui implements a minimal, scrollback-friendly terminal UI used when docker-agent runs with --lean. Unlike the full bubbletea TUI it never switches to the alternate screen: finished conversation content is committed into the terminal's normal scrollback while a small live region (the input box and status footer) stays pinned to the bottom and is redrawn in place.

The package is intentionally self-contained. It builds on a handful of low-level Charmbracelet dependencies (lipgloss for styling, x/ansi for cell math and escape sequences) and implements its own input parser, differential renderer, and input editor rather than relying on a full TUI framework.

Index

• func Run(ctx context.Context, cfg Config) error
• type Config

Functions

func Run

func Run(ctx context.Context, cfg Config) error

Run drives the lean TUI until the user exits. It owns the terminal (raw mode, no alternate screen) for its lifetime and restores it on return.

Types

type Config

type Config struct {
	App        *app.App
	WorkingDir string
	Cleanup    func()

	FirstMessage           *string
	FirstMessageAttachment string
	QueuedMessages         []string

	AppName          string
	DisabledCommands []string

	// Banner overrides the ASCII-art welcome banner. When nil the built-in
	// bannerLines ("docker agent") is used; embedders set it to brand the lean
	// TUI with their own art (each line ideally within 56 columns).
	Banner []string
}

Config wires the lean TUI to a prepared App and the initial run parameters.