Non-interactive Mode

Non-interactive mode runs a single prompt and exits. Use it when you want IaC Code to produce output for a repeatable task without staying in the REPL.

Use --prompt to pass the prompt directly:

iac-code --prompt "Create an OSS Bucket"

Use --prompt - to read the prompt from standard input:

echo "Create a VPC and two ECS instances" | iac-code --prompt -

Use --output-format when the caller needs structured output:

iac-code --prompt "Create an OSS Bucket" --output-format json

Use --max-turns to bound how long the agent can work:

iac-code --prompt "Create a VPC" --max-turns 20

Supported output formats are:

Format	Purpose
text	Human-readable output. This is the default.
json	A single JSON result for callers that parse the final response.
stream-json	Streaming JSON events for callers that process incremental progress.

Permission Control in Automation

When running non-interactively, use --permission-mode to control how the agent handles tool approvals:

iac-code --prompt "Deploy the stack" --permission-mode bypass_permissions

To restrict what the agent can do, combine --allowed-tools and --disallowed-tools:

iac-code --prompt "Check the stack status" \
  --allowed-tools 'bash(git *),bash(ls:*)' \
  --disallowed-tools 'bash(rm *)' \
  --permission-mode dont_ask

For all startup flags, see Command Line Options.