Troubleshoot the Teamwork Graph CLI
This experience is currently in beta.
If you run into issues with Teamwork Graph CLI, use this page to diagnose common problems, keep the CLI up to date, and get help.
Run all of these troubleshooting commands from your terminal.
Run a health check
To check your authentication, connectivity, and build info, run:
twg doctorThis is always the best first step — it tells you what's working and what isn't.
Repair your setup
If twg doctor reports issues with your configuration or agent skills, run:
twg setupThis re-runs the setup process and refreshes your agent skill files without reinstalling the binary.
Update Teamwork Graph CLI
If you're on version 0.9.6 or earlier, twg update may not work correctly. Instead, follow these steps to update it manually.
macOS and Linux — curl installer (recommended for older versions):
curl -fsSL https://teamwork-graph.atlassian.com/cli/install -o twg-install.sh
bash twg-install.shWindows — PowerShell:
curl.exe -fsSL https://teamwork-graph.atlassian.com/cli/install.ps1 -o twg-install.ps1
powershell -ExecutionPolicy Bypass -File .\twg-install.ps1Windows — Command Prompt:
curl.exe -fsSL https://teamwork-graph.atlassian.com/cli/install.ps1 -o twg-install.ps1
powershell -ExecutionPolicy Bypass -File twg-install.ps1If you're on version 0.9.7 or later and want to use the built-in updater:
twg updateTo see what's changed in recent versions, view the TWG CLI changelog
Common issues
Issue | Solution |
|---|---|
| Add the line printed by the installer to your shell profile (for example, |
Windows SmartScreen warning during install | Select More info, then Run anyway. This is expected for pre-release builds that don't yet have a production code signature. |
Authentication fails after update | Run |
Bitbucket commands not working | Bitbucket requires a separate token. Re-run |
Share feedback or report a bug
Was this helpful?