Interactive TUI

A real-time dashboard for every service. CPU, memory, uptime, logs – keyboard-driven, no mouse, no context switch.

Six services, one screen

When you run fuku (or fuku run), it launches an interactive terminal UI showing all services, their status, resource usage, and uptime.

Built for the keyboard

The aside panel

Press Enter on a service to open a read-only info aside next to the services list. It has three tabs — config, env, and health — cycled with Tab / Shift+Tab:

• config — working directory, start command, tier, per-service log outputs, watch globs and debounce
• env — merged contents of the service's .env files (display only; values are not exported to the child process)
• health — readiness probe details (type/address/URL/pattern), PID, uptime, retry policy, and the current lifecycle state with how long it has held

Press \ to toggle keyboard focus between the services list and the aside — the focused panel takes the highlighted border and routes ↑/↓, PgUp/PgDn, and Home/End. The aside auto-fits the services list to the longest service name (capped at a medium width so one very long name cannot keep stealing aside space — names beyond the cap are truncated in the services column) and donates the rest of the terminal width to the panel; on terminals too narrow to fit both, the panel stays hidden and the services list keeps the full width. Press Esc to close the aside (or Enter again to toggle it shut).

Find services fast

Press / to enter filter mode. Type a query to narrow the service list by name — matching is case-insensitive and works on partial names.

While typing, use ↑/↓ arrow keys to navigate filtered results. Press Enter to confirm the filter and switch to full navigation (j/k, s, r). Press Esc to clear the filter and restore the full list. If the info aside is open, Esc closes the aside first; pressing it again clears the filter.

The filter bar appears in the bottom border alongside CPU/memory stats. A cursor (_) indicates active input mode.

Live CPU and memory

The TUI shows real-time CPU and memory usage for each service, sampled periodically via gopsutil. Aggregate CPU and memory are displayed in the bottom border.

No-UI mode

If you prefer plain log output without the interactive dashboard, use --no-ui:

fuku run core --no-ui

This streams service logs directly to your terminal with service name prefixes – useful for CI, scripting, or when you want simple output.