CLI Reference

#Modes

flux                         # Interactive terminal UI
flux run "prompt"            # Non-interactive agent mode with dynamic context
flux -P "prompt"             # Print one final response and exit
flux update [version]        # Update the installed release

#Options

Option Description
--provider, -p anthropic, openai, gemini, or ollama
--model, -m Provider model identifier
--effort low, medium, high, or max
--ollama-host Ollama host when no complete endpoint is set
--ollama-port Ollama port
--ollama-endpoint Complete Ollama base URL
--ollama-api-key Ollama bearer token
--print, -P Print mode
--stream Stream print-mode response text
--output-schema <json|@file> Validate print-mode output against JSON Schema
--permission <json> Tool policy for flux run
--max-turns <number> Limit iterations in flux run
--resume, -r [id] Open the session picker or resume by ID prefix
--auto-accept, -y Skip normal tool confirmations
--deny-writes Block write operations
--version, -v Print the version
--help, -h Print help

Both --option value and --option=value are accepted for provider, model, effort, Ollama values, output schema, permissions, and max turns.

#Environment variables

Variable Purpose
ANTHROPIC_API_KEY Anthropic credential
OPENAI_API_KEY OpenAI credential
GEMINI_API_KEY Gemini credential
OLLAMA_ENDPOINT Complete Ollama endpoint
OLLAMA_HOST / OLLAMA_PORT Ollama address components
OLLAMA_API_KEY Ollama bearer token
FLUX_PERMISSION JSON policy used by flux run
FLUX_NO_UPDATE=1 Disable automatic update checks
FLUX_NO_SANDBOX=1 Disable automatic shell sandbox selection
LIBREOFFICE_PATH Office document conversion executable