CLI Reference

Complete reference for the openfleet command-line interface. All flags can be combined. Run openfleet --help for a quick summary.

Core Commands

Flag	Description
`openfleet`	Start supervisor in foreground mode
`--setup`	Run the interactive setup wizard
`--doctor`	Validate config (.env + JSON + env overrides)
`--help`	Show CLI help text
`--version`	Print current version
`--update`	Check for and install latest version

Daemon Mode

Flag	Description
`--daemon`, `-d`	Run as a background daemon (detached, PID file)
`--stop-daemon`	Stop a running daemon process
`--daemon-status`	Check if daemon is running

Example

# Start daemon
openfleet --daemon

# Check status
openfleet --daemon-status
# → openfleet daemon is running (PID: 12345)

# Stop
openfleet --stop-daemon

Startup Service

Flag	Description
`--enable-startup`	Register auto-start on login
`--disable-startup`	Remove from startup services
`--startup-status`	Check if startup service is installed

Orchestrator Options

Flag	Default	Description
`--script <path>`	auto	Path to the orchestrator script
`--args "<args>"`	`-MaxParallel 6`	Arguments passed to the orchestrator
`--restart-delay <ms>`	`10000`	Delay before restart on crash
`--max-restarts <n>`	`0` (unlimited)	Max restarts (0 = unlimited)

Logging Options

Flag	Description
`--log-dir <path>`	Log file directory (default: `./logs`)
`--echo-logs`	Echo raw orchestrator output to console
`--quiet`, `-q`	Only show warnings and errors
`--verbose`, `-V`	Show debug-level messages
`--trace`	Show all messages including trace-level
`--log-level <level>`	Explicit level: `trace\|debug\|info\|warn\|error\|silent`

AI / Agent Options

Flag	Description
`--no-codex`	Disable Codex SDK analysis
`--no-autofix`	Disable automatic error fixing
`--primary-agent <name>`	Override primary agent: `codex`, `copilot`, `claude`
`--shell`, `--interactive`	Enable interactive shell mode in monitor

Telegram Flags

Flag	Description
`--no-telegram-bot`	Disable the interactive Telegram bot
`--telegram-commands`	Enable monitor-side Telegram polling (advanced)

WhatsApp Flags

Flag	Description
`--whatsapp-auth`	Run WhatsApp authentication (QR code)
`--whatsapp-auth --pairing-code`	Authenticate via pairing code instead

Vibe-Kanban Flags

Flag	Default	Description
`--no-vk-spawn`	—	Don't auto-spawn Vibe-Kanban
`--vk-ensure-interval <ms>`	`60000`	VK health check interval

Sentinel Flags

Flag	Description
`--sentinel`	Start Telegram sentinel in companion mode
`--sentinel-stop`	Stop a running sentinel
`--sentinel-status`	Check sentinel status

Update Flags

Flag	Description
`--no-update-check`	Skip automatic update check on startup
`--no-auto-update`	Disable background auto-update polling

Companion CLI Tools

OpenFleet also installs these companion binaries:

Command	Description
`openfleet-setup`	Direct setup wizard launcher
`openfleet-chat-id`	Discover your Telegram chat ID
`openfleet-shared-workspaces`	Manage shared workspace registry
`vibe-kanban`	Standalone Vibe-Kanban CLI wrapper
`telegram-sentinel`	Standalone sentinel launcher

ℹ️

Legacy aliases openfleet and openfleet-setup still work for backwards compatibility.