Automation and Scripting

Use this page when you want to run aisw safely from scripts, CI, or shell automation.

Prompt behavior

aisw does not currently provide a global --non-interactive or --quiet flag.

Current automation-safe usage:

• Use --yes for commands that otherwise prompt for confirmation:
  • aisw init --yes
  • aisw remove ... --yes
  • aisw backup restore ... --yes
• Use aisw add ... --api-key ... when you need non-interactive profile creation. Without --api-key, aisw add uses an interactive auth flow.
• Use --json for machine-readable inventory and status output:
  • aisw list --json
  • aisw status --json
  • aisw backup list --json
• aisw use --emit-env and aisw shell-hook intentionally print raw shell output for scripting and shell integration.

If you need fully non-interactive automation today, prefer API-key-based add, explicit --yes flags, and the JSON output modes above.

Output contract

aisw uses this output model:

• Human-oriented command results and status output go to stdout.
• Errors are printed to stderr and return a non-zero exit code.
• Interactive prompts appear during prompt-driven flows such as init, remove, and backup restore when you do not pass --yes.
• --json modes are the supported machine-readable interface for scripting.
• aisw use --emit-env and aisw shell-hook intentionally emit raw shell text to stdout.

Supported JSON interfaces:

• aisw list --json
• aisw status --json
• aisw backup list --json

JSON output is intended to remain stable for automation within a released major version. Human-readable stdout should be treated as presentation output and may change between releases.

Practical patterns

Create a profile without prompts

aisw add claude work --api-key "$ANTHROPIC_API_KEY"

Remove a profile non-interactively

aisw remove claude work --yes

Read profile inventory from a script

aisw list --json

Export shell variables for the selected profile

eval "$(aisw use codex work --emit-env)"

Recommended references

• Commands for the full command and flag reference
• Shell Integration for hook and completion setup
• Quickstart for the common interactive workflow