Skip to main content

CLI reference

Use agent-terminal --help (or the command-specific help) as the installed version's authoritative reference. The normal workflow is: open a workspace, capture a request, review the proposed action, and inspect the result.

Safe command habits

  • Start with agent-terminal --help and the status/version commands exposed by the installed release.
  • Keep the active workspace explicit.
  • Review destructive commands before approving them.
  • Prefer a dry run or a disposable checkout for unfamiliar automation.
  • Keep credentials in environment variables or the provider credential store.

Troubleshooting

If voice capture, a model endpoint, or a workspace command is unavailable, check the app status panel first, then retry the smallest action. Capture the visible error and command result when asking for support; remove secrets first.