Troubleshoot TWG CLI

Your shell can’t find the TWG CLI binary. This usually means the install directory isn’t in your PATH.

To fix:

Run ls ~/.local/bin/twg to confirm TWG CLI was installed.
If the file exists, add ~/.local/bin to your PATH. The installer should have shown you the exact line to add.
Restart your terminal, then run twg --version to confirm it works.

原因	修正
Wrong API token type	You must use a classic (unscoped) API token, not a scoped token. See Get started with TWG CLI.
Token expired or revoked	Create a new token at id.atlassian.com and run `twg login` again.
Wrong site name	The site name should be just the subdomain, for example `mycompany` not `mycompany.atlassian.net`.
Wrong email	Confirm the email matches your Atlassian account.

Your agent isn’t querying Atlassian data even though TWG CLI is installed.

To fix:

Run twg skills install to confirm skills are installed.
Check that skills were installed into your project folder (.agents/skills/twg/). Some agents only pick up skills from a project-level folder.
Restart your agent or editor session after installing.

Windows may show a SmartScreen warning when running the installer.

To proceed: Select More info, then select Run anyway.

If Bitbucket-specific prompts fail but Jira and Confluence work, you may not have configured a Bitbucket app password.

To fix: Run twg login again and follow the prompts to enter your Bitbucket app password.

TWG CLI includes a built-in diagnostic command that checks whether your setup is working correctly.

twg doctor

Each check shows as pass or fail with a short message.

チェックマーク	意味
Build info	Confirms TWG CLI is installed and shows the current version.
認証	Confirms your Atlassian credentials are saved and readable.
API connectivity	Tests whether TWG CLI can reach the Atlassian API with your credentials.
Skills installed	Checks whether agent skills are installed in your project.

Failed check	What to do
Build info	Re-install TWG CLI. See Get started with TWG CLI.
認証	Run `twg login` again. See Get started with TWG CLI.
API connectivity	Check your network connection and confirm your API token is valid. If on a VPN, confirm Atlassian domains are accessible.
Skills installed	Run `twg skills install`. See Get started with TWG CLI.

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。