CLI Commands

Command reference, flags, TUI controls, and environment file loading.

Commands

Command	Alias	Description
`fuku run [profile]`	`r`	Run services for a profile (default if omitted)
`fuku logs [services...]`	`l`	Stream logs from a running fuku instance
`fuku init`	`i`	Generate a `fuku.yaml` template
`fuku version`	`-v`, `--version`	Show version
`fuku help`	`-h`, `--help`	Show help

Flags

Flag	Description
`--no-ui`	Run without the interactive TUI (log-only mode)
`--profile`	Filter by profile (used with `logs` command)

Flags can be placed in any position:

fuku run core --no-ui
fuku --no-ui run core        # Same result

Usage Examples

# Run with TUI (default profile)
fuku

# Run a specific profile without TUI
fuku run core --no-ui

# Use short aliases
fuku r core

# Stream logs from running instance (separate terminal)
fuku logs                       # All services
fuku logs api auth              # Specific services
fuku logs --profile core api    # Filter by profile
fuku l api db                   # Short alias

# Generate config template
fuku init

# Show help / version
fuku help
fuku version

TUI Controls

When running with the interactive TUI (default), use these keyboard shortcuts:

Key	Action
`↑` / `↓` or `k` / `j`	Navigate services
`PgUp` / `PgDn`	Scroll viewport
`Home` / `End`	Jump to start / end
`r`	Restart selected service
`s`	Stop / start selected service
`q`	Quit (stops all services)

Environment File Loading

Fuku automatically loads environment files using godotenv, in this order (later files take precedence):

.env
.env.<GO_ENV>
.env.<GO_ENV>.local

If a service directory contains a .env.development file, it is automatically detected and passed to the service via the ENV_FILE variable.