Troubleshooting

Getting Help

Before filing an issue, please run your command with the --debug flag to get the full output, which is very helpful for diagnosing problems.

autowt --debug <command-that-is-failing>

Common issues

Terminal control on macOS

Symptom: autowt doesn't open a new terminal tab/window, or it fails to switch to an existing session on macOS.

This is almost always a permissions issue. autowt uses AppleScript to control your terminal, which requires you to grant access.

Solution:

1. Open System Settings.
2. Navigate to Privacy & Security.
3. Grant your terminal application (e.g., iTerm.app, Terminal.app) permissions for both Accessibility and Automation.