Crate agentmux_launcher 

Modules

autostart 🔒

Auto-start-at-login registration — issue #2977 Workstream 2, docs/specs/SPEC_TRAY_OPTIONAL_BACKGROUND_SERVICE_2026_09_04.md §4.

background_config 🔒

The tray icon and background-service mode, resolved by the launcher at startup — docs/specs/SPEC_OS_NOTIFICATIONS_SYSTEM_2026_09_24.md §4.1.

binary_resolution 🔒

data_dir 🔒

Compatibility shim around agentmux_common::DataPaths.

diag 🔒

event_log 🔒

hash 🔒

host_hang_dump 🔒

SPEC_HOST_UI_THREAD_HANG_WATCHDOG_2026_08_14 §1–2 — capture evidence of a wedged host UI thread before anything (a person, usually) kills it.

host_pipe 🔒

host_spawn 🔒

ipc 🔒

job_object 🔒

logging 🔒

mem_supervisor 🔒

Memory-pressure-aware host supervision — P0 of docs/specs/SPEC_MEMORY_PRESSURE_SUPERVISION_2026_06_16.md.

notify 🔒

OS notification Presenter — docs/specs/SPEC_OS_NOTIFICATIONS_SYSTEM_2026_09_24.md §3.2, §6.

other_instances 🔒

Read-only detection of OTHER AgentMux (channel, version) instances currently running on this machine, for diagnostic logging ONLY.

reducer 🔒

saga 🔒

second_instance 🔒

splash_config 🔒

“Disable the splash” preference, resolved by the launcher before it spawns the splash (and before the host/srv exist), per SPEC_SPLASH_USERINFO_AND_DISABLE_2026_06_21.md §6.

splash_core 🔒

Shared startup-splash timeline logic: the row model, event application with same-tick count-up deferral, a frozen-row finalizer, duration formatting, and total/other reconciliation — used identically by all three platform splash renderers (splash.rs Windows, splash_mac.rs macOS, splash_linux/ Linux).

splash_font 🔒

splash_info 🔒

Identity shown in the splash footer: user@host and v<version> (+ a dev label on non-stable builds). Gathered once in the launcher and handed to each platform’s splash backend, so the three render identical content.

splash_linux 🔒

Session-aware Linux startup splash.

splash_text 🔒

Software text blitter for the splash footer — shared by the Linux software buffers (splash_linux) and the Win32 layered-window DIB (splash.rs). macOS uses native NSTextField instead, so it does not use this module.

srv_spawner 🔒

stale_srv 🔒

Reclaim the data dir from an srv that an earlier launcher left behind.

start_at_login 🔒

app:startatlogin: one setting, three views (docs/specs/SPEC_START_WITH_OS_2026_09_25.md §3.9).

startup_events 🔒

Startup event bus: typed events emitted by each launcher startup stage and consumed by the native splash screen renderer.

state 🔒

supervisor 🔒

Platform host-supervision loops. The Windows and Unix supervisors are fully #[cfg]-gated in separate files; only the flow spine (launcher_main) lives at the crate root.

teardown_backstop 🔒

SPEC_LAUNCHER_TEARDOWN_BACKSTOP_2026_07_11 Phase 2 — the armed J0 teardown state machine.

tray 🔒

Optional system-tray / menu-bar icon — issue #2977 Workstream 1, docs/specs/SPEC_TRAY_OPTIONAL_BACKGROUND_SERVICE_2026_09_04.md.

ui_liveness 🔒

SPEC_LAUNCHER_TEARDOWN_BACKSTOP_2026_07_11 Phase 1 — UI-thread liveness telemetry (observe-only).

upgrade 🔒

Phase 1 of the fast-startup redesign (docs/specs/SPEC_FAST_STARTUP_UPGRADE_OWNS_MIGRATIONS_AND_UPDATES_2026_09_15.md, tracked by issue #3258) — the primitives a “quiesce srv, run pending migrations, come back” upgrade action needs, built and tested in isolation ahead of wiring them into a live caller.

wrr 🔒

Functions

launcher_main 🔒

main 🔒

Process entry point. suppress_os_crash_dialogs() runs FIRST — before the Tokio runtime is built. The runtime is built explicitly here (rather than via #[tokio::main], whose generated wrapper would construct it before any of our code runs) so a fault during runtime construction can’t surface the Windows crash modal either. Spec: docs/specs/SPEC_SERVICE_SUPERVISION_AND_RECOVERY_2026_05_20.md.

show_fatal_dialog 🔒

splash_selftest 🔒

--splash-selftest: show the splash with no srv/host behind it, hold it for a few seconds (or AGENTMUX_SPLASH_HOLD_MS), then exit. A demo/dev affordance for eyeballing the footer + centering without launching the whole app.

suppress_os_crash_dialogs 🔒