Fix common Teamwork Graph CLI issues

If your Teamwork Graph (TWG) CLI setup isn’t working as expected, use this guide to diagnose and fix common issues. Each section covers a specific problem with steps to resolve it, so you can get back to working with your Atlassian tools quickly.

一般的な課題

“Command not found: twg” after installing

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

To fix:

1. Run ls ~/.local/bin/twg to confirm TWG CLI was installed.

2. If the file exists, add ~/.local/bin to your PATH. The installer should have shown you the exact line to add.

3. Restart your terminal, then run twg --version to confirm it works.

Authentication fails or “Unauthorized” error

You might see this error for several reasons:

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 that the email matches your Atlassian account.

Your agent isn’t using TWG CLI skills

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

To fix:

1. Run twg skills install to confirm skills are installed.

2. Check that skills were installed into your project folder (.agents/skills/twg/). Some agents only pick up skills from a project-level folder.

3. Restart your agent or editor session after installing.

Windows SmartScreen warning during install

Windows may show a SmartScreen warning when you run the installer.

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

Bitbucket commands return errors

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

To fix: Run twg login again and follow the prompts to enter your Bitbucket app password. Once complete, retry your Bitbucket command to verify it works.

Check your setup with twg doctor

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

Run the check

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

What twg doctor checks

チェックに失敗した場合

ビルド情報: TWG CLI を再インストールします。「TWG CLI の利用を開始する」を参照してください。完了後、確認のために再度 twg doctor を実行してください。

認証: twg login を再度実行します。「TWG CLI の利用を開始する」を参照してください。完了後、確認のために再度 twg doctor を実行してください。

API 接続: ネットワーク接続を確認し、API トークンが有効であることを確認してください。VPN を使用している場合は、アトラシアンのドメインにアクセスできることを確認してください。完了後、確認のために再度 twg doctor を実行してください。

スキルのインストール: twg skills install を実行します。「TWG CLI の利用を開始する」を参照してください。完了後、確認のために再度 twg doctor を実行してください。