SEA-Forgeā„¢ CLI Reference

Complete command reference for the sea-forge CLI.


Global Flags

Flag Description
--verbose, -v Enable debug output
--dry-run Show what would happen without changes
--help, -h Show help
--version, -V Show version

Commands

doctor

Check system prerequisites and environment health.

1
2
sea-forge doctor
sea-forge doctor --verbose  # Show installation hints

init

Initialize or refresh project dependencies.

1
2
sea-forge init
sea-forge init --yes  # Skip prompts

up

Start all services.

1
2
3
sea-forge up                  # Start detached
sea-forge up --watch          # Start + self-healing
sea-forge up --service mongo  # Start specific service

down

Stop all services.

1
2
sea-forge down
sea-forge down --volumes  # Remove data (destructive!)

apply

Apply declared state from sea-forge.yaml.

1
2
3
sea-forge apply
sea-forge apply --force   # Re-apply even if unchanged
sea-forge apply --dry-run # Preview changes

watch

Self-healing monitor (continuous).

1
2
sea-forge watch
sea-forge watch --interval 60  # Check every 60s

Press Ctrl+C to stop.


status

Check service health.

1
sea-forge status

logs

View service logs.

1
2
3
4
sea-forge logs              # All services
sea-forge logs librechat    # Specific service
sea-forge logs -f           # Follow mode
sea-forge logs -n 100       # Last 100 lines

setup

Interactive setup for LibreChat + Zed IDE.

1
2
3
sea-forge setup
sea-forge setup --skip-zed       # LibreChat only
sea-forge setup --skip-librechat # Zed only

validate

Run spec-guard validation.

1
2
sea-forge validate
sea-forge validate --file docs/specs/shared/sds/001-example.sds.yaml