---

name: lingtai-update-command description: Use when operating /update-tui or lingtai-tui self-update. version: 1.0.0 last_changed_at: "2026-07-18T00:00:00Z" maintenance: "If you find stale or incorrect information here, use the lingtai-issue-report skill to assemble evidence and obtain per-issue human consent before filing an issue. Never include secrets, credentials, tokens, or private paths."

/update-tui

Nested lingtai-update reference. /update-tui compares the running TUI with the latest GitHub release, detects the install method, and requires explicit confirmation before changing the TUI binary; the selected distribution may also refresh the co-installed portal binary. It never updates the Python kernel, presets, or utility library, and never auto-restarts the current TUI — relaunch after a successful update.

• Homebrew: migrates to LingTai's native installer instead of running brew. Runs the version-pinned raw release script https://raw.githubusercontent.com/Lingtai-AI/lingtai/<tag>/install.sh with --update --prefix <native-prefix> --version <tag> --non-interactive, accepting and updating existing managed runtime/receipt state in place while preserving the exact target tag rather than using ordinary first-install mode. then verifies the new install.json source metadata, the binary version at the new bin_dir, and the Python runtime. On any migration failure the old Homebrew formula/keg remains exactly as usable as before the attempt — the migration step itself never runs brew. Before reporting success, the migration also resolves lingtai-tui on PATH and checks it against the freshly installed binary — on a standard Apple-Silicon Homebrew host, /opt/homebrew/bin is earlier on PATH than install.sh's default native bin dir, so a fresh native install alone does not make the shell start running it. When PATH still resolves to Homebrew, the migration reports "native installed, migration not complete" instead of "Migrated!", and every update entry point (startup prompt, self-update, doctor) re-detects and re-reports that same truthful state on every subsequent run — it does not re-run the installer and does not claim success until PATH actually resolves the native binary. Only once that is confirmed does detectTUIInstallMethod report the install as source/user-local going forward, so subsequent updates use the source path below instead of brew.
• Source/user-local: runs the versioned install.sh --update --prefix ... --version <tag> --non-interactive path and verifies the result.

If a legacy ~/.lingtai-tui/runtime exists before a native receipt, the installer's documented recovery path is a TUI-only install with --skip-python (or --skip-venv): it preserves that runtime unchanged and publishes the native binaries/receipt beside it. Use the standalone fix.sh with an explicitly named free runtime child only after reviewing its read-only diagnosis; it must create a parallel runtime and never overwrite the legacy one.

• Unknown/other or non-comparable/dev versions: reports guidance and does not guess a package manager.

Homebrew removal is a separate, interactive-only decision. Once a native install is verified — either right after a fresh migration's PATH takeover succeeds, or on a later launch that redetects an existing verified-but-shadowed install — the interactive startup prompt (not /update-tui's Bubble Tea view, not self-update, not doctor) asks a concrete second question: "Remove the old Homebrew installation now? [y/N]" (default No). Only an explicit "y" runs the single injected uninstall (brew uninstall lingtai-ai/lingtai/lingtai-tui, exactly this formula), then re-resolves lingtai-tui on ordinary PATH and requires it to match the verified native binary before reporting cleanup complete — the currently running Homebrew process is never treated as proof. A declined prompt, a failed uninstall, or PATH still not resolving to the native binary afterward all leave removal reported as pending, and the same question is asked again on the next interactive launch. self-update, doctor, and /update-tui never ask this question and never run brew uninstall — they only report both the native and Homebrew paths/versions and the exact manual command.

lingtai-tui self-update is the shell command for the same manual update surface when the interactive TUI is unavailable. lingtai-tui doctor is a broader repair/report path that can also run the detected TUI backend; use this skill only for its TUI/portal side and defer Python-runtime decisions to the kernel system-manual runtime/kernel update manual.