fuku

Service orchestrator for local development

Lightweight CLI tool for running and managing multiple local services. Tier-based startup ordering, interactive TUI, hot-reload, and readiness checks — all from a single YAML config.

Fuku interactive TUI showing running services

Features

Interactive TUI

Real-time service dashboard with CPU/memory monitoring, log viewing, and keyboard-driven controls.

Service Orchestration

Tier-based startup ordering ensures dependencies come up before the services that need them.

Graceful Shutdown

SIGTERM/SIGKILL lifecycle management stops services in reverse order for clean teardown.

Profile Support

Group services into named profiles to start exactly what you need for your current task.

Readiness Checks

HTTP, TCP, and log-based health checks confirm services are truly ready before proceeding.

Hot-Reload

File watcher with debouncing automatically restarts services when source files change.

Log Streaming

Unix socket-based log streaming with service filtering and formatted output.

Pre-flight Cleanup

Detects and kills orphaned processes from previous runs before starting fresh.

Install

Homebrew

brew install tab/apps/fuku

Build from source

git clone https://github.com/tab/fuku.git
cd fuku
go build -o cmd/fuku cmd/main.go
sudo ln -sf $(pwd)/cmd/fuku /usr/local/bin/fuku