Troubleshoot TWG CLI

If you run into issues with Teamwork Graph CLI (TWG CLI), use this page to diagnose common problems, keep the CLI up to date, and get help.

Run a health check

To check your authentication, connectivity, and build info, run:

1
2
twg doctor

This 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:

1
2
twg setup

This re-runs the setup process and refreshes your agent skill files without reinstalling the binary.

Update TWG CLI

If you're on version 0.9.6 or earlier, twg update may not work correctly. Use the manual update steps below instead.

macOS and Linux (curl installer, recommended for older versions)

1
2
curl -fsSL https://teamwork-graph.atlassian.com/cli/install -o twg-install.sh
bash twg-install.sh

Windows (PowerShell)

1
2
curl.exe -fsSL https://teamwork-graph.atlassian.com/cli/install.ps1 -o twg-install.ps1
powershell -ExecutionPolicy Bypass -File .\twg-install.ps1

Windows (Command Prompt)

1
2
curl.exe -fsSL https://teamwork-graph.atlassian.com/cli/install.ps1 -o twg-install.ps1
powershell -ExecutionPolicy Bypass -File twg-install.ps1

If you're on version 0.9.7 or later and want to use the built-in updater, run:

1
2
twg update

For full installation options, see Set up TWG CLI.

Get help and give feedback

To see what's changed in recent versions, view the changelog.

To give feedback or report an issue, use the CLI to submit feedback with prefilled details, or submit feedback directly through the TWG CLI feedback form.

Review the details, provide an email if needed, complete reCAPTCHA, and submit the form.