internal/

Package config loads and represents amux configuration: assistant definitions, UI settings, and resolved on-disk paths.

Package data persists workspace records to disk via WorkspaceStore, using atomic JSON reads/writes keyed by workspace ID plus per-repo lookup.

Package fsatomic provides crash-safe single-file persistence: data is written to a temp file in the target directory, synced to disk, and then atomically moved over the target.

Package git wraps the git CLI for amux's worktree-per-workspace model: creating and removing worktrees and branches, computing diffs, and watching the working tree for changes.

Package logging is amux's file-based logger.

Package messages defines the shared Bubble Tea message vocabulary exchanged between the app message pump and the UI panes: user intents, lifecycle events, and cross-pane notifications.

Package perf is lightweight, opt-in instrumentation: named counters (Count) and timers (Record/Time) that flush to a log for the headless harness and the perf baselines.

Package pprofhttp builds the opt-in pprof server used by amux binaries.

Package process provides cross-platform process-group teardown: it kills a process together with its descendants (KillProcessGroup) so agent process trees do not survive the tmux session that launched them.

Package pty manages the pseudo-terminals that back hosted agents: it spawns agent processes (Agent) attached to a PTY (Terminal), sizes them, and streams their byte output to the UI for parsing by internal/vterm.

Package safego provides panic-safe goroutine helpers (Go, Run) with a pluggable PanicHandler, so background work can never crash the TUI on an otherwise-unrecovered panic.

Package shellutil holds small, security-sensitive shell helpers shared across packages so their behavior can't drift between copies.

Package supervisor runs named background workers under a restart/backoff policy and surfaces fatal worker errors through a pluggable error handler instead of letting an unrecovered failure take down the app.

Package testutil provides small polling helpers shared across test packages, so individual tests don't re-derive deadline/poll loops (which tend to drift in interval and failure messaging).

Package tmux is a thin wrapper over the tmux CLI used to host agent sessions: it creates and kills sessions, captures pane contents and scrollback, resizes windows, and reads/writes the @amux_* activity tags that coordinate detection and reattach across amux instances.

Package update implements self-update: it compares the running version against GitHub releases and downloads, checksum-verifies, and installs a newer binary, skipping Homebrew and go-install builds.

Package validation guards untrusted input before it reaches git or the filesystem: it sanitizes strings and validates assistant names, base refs, project paths, and workspace names.

Package vterm is a terminal emulator: it parses a stream of ANSI/VT escape sequences into a cell grid plus scrollback and renders that state back to ANSI.