Teamwork Graph CLI の一般的な問題を修正する

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

twg setup

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

If you still encounter errors, check your network connection and confirm your API token is valid. If you’re on a VPN, confirm that Atlassian domains are accessible. Once resolved, run twg doctor again to verify.

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.sh

Windows — PowerShell:

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:

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:

twg update

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

一般的な課題

Issue	ソリューション
`Command not found: twg` after installing	`ls ~/.local/bin/twg` を実行して、TWG CLI がインストールされたことを確認します。ファイルが存在する場合は、`~/.local/bin` を PATH に追加します。追加する正確な行は、インストーラーに表示されたものです。ターミナルを再起動し、`twg --version` を実行して動作を確認します。
`~/.local/bin` not in PATH	Add the line printed by the installer to your shell profile (for example, `~/.zshrc` or `~/.bashrc`), then restart your terminal.
インストール中に Windows SmartScreen の警告が表示される	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 `twg login` to re-authenticate. If using a scoped token for Bitbucket, run `twg login --pat`. Check your site name is just the subdomain, for example `mycompany` not `mycompany.atlassian.net` and that your email matches your Atlassian account.
Agent isn’t using TWG CLI skills	`twg skills install` を実行して、スキルがインストールされていることを確認します。スキルがプロジェクトフォルダー (`.agents/skills/twg/`) にインストールされたことを確認します。一部のエージェントは、プロジェクトレベルのフォルダーからのみスキルを取得します。インストール後、エージェントまたはエディターのセッションを再起動します。
Bitbucket commands not working	Bitbucket requires a separate token. Re-run `twg setup` or `twg login` and follow the optional Bitbucket token prompt.

Share feedback or report a bug

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

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

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

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

コミュニティに質問