CLI¶
Run agents from the command line.
Commands¶
run¶
uv run textagents run <agent_file> [--<input> VALUE] [--inputs FILE] [--format json|pretty] [--model MODEL]
# Inline inputs
uv run textagents run judge.txt --statement "The sky is blue."
# From JSON file
uv run textagents run judge.txt --inputs data.json
# Load input from file
uv run textagents run judge.txt --text @document.txt
# Override model
uv run textagents run judge.txt --text "test" --model openai:gpt-4o-mini
info¶
Shows agent configuration, inputs, and output fields.
validate¶
Validates agent definition without running. Exit code 0 if valid.
Environment Variables¶
The CLI loads .env automatically: