Hot-Reload

Edit a file, save, fuku restarts the affected service. Debouncing prevents storms. Shared paths handle cross-service deps.

Native fsnotify, debounced

fuku watches file system events in your service directories and restarts the affected service when matching files change. A debounce timer prevents restart storms when multiple files change at once (e.g., during a git checkout).

│ ✓ api         running  pid 76758
│ ✓ worker      running  pid 76759
│
│ watch  file changed: api/handlers/users.go
│ watch  file changed: api/handlers/users.go
│ watch  debounce 500ms
│
│ ○ api         restarting
│   stopping pid 76758...
│   starting...
│ ✓ api         running  pid 76801

Per-service watch config

services:
  api:
    dir: ./api
    watch:
      include: ["**/*.go"] # Glob patterns to watch
      ignore: ["**/*_test.go"] # Patterns to ignore
      shared: ["pkg/common"] # Shared paths (triggers restart)
      debounce: 500ms # Wait time after last change

Shared paths

If multiple services depend on a shared library (e.g., pkg/common), add it to shared. When files in that path change, the service restarts – even though the files are outside its own directory.

services:
  api:
    dir: ./api
    watch:
      include: ["**/*.go"]
      shared: ["pkg/common", "pkg/models"]

  worker:
    dir: ./worker
    watch:
      include: ["**/*.go"]
      shared: ["pkg/common"]

│ watch  file changed: pkg/common/auth.go
│ watch  shared path match → api, worker
│
│ ○ api         restarting
│ ○ worker      restarting
│ ✓ api         running  pid 76820
│ ✓ worker      running  pid 76821