#Modes
agav # Interactive terminal UI
agav run "prompt" # Non-interactive agent mode with dynamic context
agav -P "prompt" # Print one final response and exit
agav 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 agav run |
--max-turns <number> |
Limit iterations in agav 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 |
AGAV_PERMISSION |
JSON policy used by agav run |
AGAV_NO_UPDATE=1 |
Disable automatic update checks |
AGAV_NO_SANDBOX=1 |
Disable automatic shell sandbox selection |
LIBREOFFICE_PATH |
Office document conversion executable |
