Configuration
The current CLI is configured with explicit flags and provider environment variables, so each run remains inspectable and reproducible.
01
Essential options
Most runs only need a repository, provider, model, and permission mode.
- --cwd PATH selects the repository root
- --provider NAME selects local, anthropic, gemini, openai-chat, or openai-responses
- --model NAME selects the provider model
- --max-turns N limits the agent loop
02
Permission modes
Use plan when you only want an inspection and proposed approach. default asks when needed, acceptEdits permits edits, and dontAsk avoids interactive permission prompts. Limit bypassPermissions to isolated automation you control.
Command
buildstax --cwd ./app --permission-mode plan --provider anthropic --model <model-name> "Plan the smallest fix."03
Fine-grained rules
Repeat --allow, --deny, or --ask-permission to override access for matching tool rules. Keep the default restrictive and add only the capability a task requires.