Skip to content

CLI Commands

VlinderCLI provides a hierarchical command structure built with clap.

Command Overview

Command Description
vlinder agent Deploy, run, list, and inspect agents
vlinder fleet Deploy and run a fleet of agents
vlinder model Add, list, and remove models from catalogs
vlinder session Inspect, fork, and promote agent sessions
vlinder turn Inspect individual turns within a session
vlinder secret Manage secrets (private keys, API keys)
vlinder daemon Start the supervisor (worker process manager)
vlinder support Interactive support — runs the bundled support fleet

Global Behavior

All commands load configuration from ~/.vlinder/config.toml by default. Configuration values can be overridden with environment variables using the VLINDER_ prefix.

The VLINDER_DIR environment variable changes the base directory for all VlinderCLI data (default: ~/.vlinder).