Docs

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.

Get Started GitHub
fuku
services starting… 4/5 ready
status cpu mem pid uptime
foundation
◉ auth running 0.1% 2MB 76741 00:11
◉ storage running 0.1% 2MB 76742 00:11
platform
◉ api running 0.1% 2MB 76758 00:09
◉ user running 0.1% 2MB 76759 00:09
edge
◉◯ frontend starting
cpu 6.2% • mem 25MB v0.15.4
↑/k up • ↓/j down • s stop/start • r restart • t tips • q quit press s to stop or start a service

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