TWG CLI をセットアップする
Set up Teamwork Graph (TWG) CLI in three steps: install, authenticate, and add agent skills. By the end, your AI coding agent will have full access to your Atlassian data — Jira work item, Confluence pages, Bitbucket repos, and more — so you can query and manage your work in plain English, no command syntax required.
はじめる前に
macOS (arm64 または x64)、Linux (x64)、または Windows (arm64 または x64) が必要です。
使用する製品にアクセスできる Atlassian アカウントが必要です。
To use TWG CLI through an agent after CLI setup, you need an AI coding agent installed on your computer.
The TWG CLI binary does not require a separate runtime (for example, no Node.js).
CLI installation mode
Use this mode when you want to install and authenticate TWG CLI directly from your terminal.
Install TWG CLI
macOS および Linux
推奨:
curl -fsSL <https://teamwork-graph.atlassian.com/cli/install> -o twg-install.sh
bash twg-install.shIf you use Bash or zsh and want a compact shortcut, you can also run:
bash <(curl -fsSL <https://teamwork-graph.atlassian.com/cli/install)>During setup:
When consent is required, answer
yes,continue, orno.Setup installs and refreshes TWG agent skills.
The installer opens your browser to sign in with OAuth. Sign in to Atlassian, select the site you want to authorize (auto-selected if you have access to only one), review the requested permissions, and select Accept.
After core setup and
twg doctorpass, setup may offer to configure the optional Bitbucket token. If you skip it, TWG CLI is still ready for non-Bitbucket commands.On macOS, setup may enable a background helper and show a system notification for Atlassian Pty Ltd or twg. This is expected. For more information, see Configure OAuth 2.1 for Teamwork Graph CLI.
The installer completes setup and runs twg doctor automatically. To repair setup later:
twg setup特定のバージョンをインストールするには、次の手順に従います。
bash twg-install.sh --version 0.9.1PATH に ~/.local/bin が含まれていない場合は、シェル プロファイルに追加する正確な行が出力されます。
Windows
Windows: SmartScreen may warn about the installer — choose More info, then Run anyway. Pre-release builds may not yet use a production code signature; that is expected until generally available signed binaries ship.
Use Windows PowerShell or Command Prompt for Windows installation. Don't run the Windows installer from Git Bash, MINGW, WSL, or another bash-like shell.
インストール - PowerShell
curl.exe -fsSL <https://teamwork-graph.atlassian.com/cli/install.ps1> -o twg-install.ps1
powershell -ExecutionPolicy Bypass -File .\twg-install.ps1インストール - コマンド プロンプト (cmd)
curl は Windows 10 1803 以降に組み込まれています。古いバージョンを使用している場合は、代わりに上記の PowerShell による方法を使用してください。
curl.exe -fsSL <https://teamwork-graph.atlassian.com/cli/install.ps1> -o twg-install.ps1
powershell -ExecutionPolicy Bypass -File twg-install.ps1The Windows installer performs the same setup as macOS and Linux: binary install, checksum verification, consent, skill install, OAuth login, and doctor verification.
During setup, the installer:
Opens your browser to sign in with OAuth. In the browser, select the site you want to authorize (auto-selected if you have access to only one), review the requested permissions, and select Accept.
Offers the optional Bitbucket token step. You can skip this unless you plan to use Bitbucket-specific commands.
Credentials are saved in the TWG config directory and reused across sessions. For re-authentication and the Bitbucket token, see Configure OAuth 2.1.
After installation, open a new PowerShell or Command Prompt window and run:
twg doctorIf Windows doesn't recognize twg, close and reopen the terminal so PATH changes are loaded, then try again.
Agent installation mode
Use this mode when you want an AI coding agent to install TWG CLI, authenticate, and set up agent skills for you.
次のプロンプトをコピーして、エージェントに貼り付けてください。
Install/setup TWG using <https://teamwork-graph.atlassian.com/cli/AGENTS.md>The agent should use that hosted AGENTS.md directly. There are no separate agent-specific install URLs.
セットアップを確認する
次のコマンドを実行します。
twg doctorこれにより、認証、接続、およびビルド情報を確認します。macOS、Linux、PowerShell、cmd でも同じように機能します。
トライアル
これで、AI コーディング エージェントが Jira、Confluence、Bitbucket などのアトラシアンのデータにアクセスできるようになりました。実現したいことを自然な言葉で説明するだけで、あとはエージェントが処理します。
「Summarize the work I did this week (今週私が行った作業をまとめて)」
「私の未解決の Jira 課題を教えて。」
「Create a Confluence page summarizing our Q2 goals (第 2 四半期の目標をまとめた Confluence ページを作成して)」
「Show the current sprint for my team (チームの現在のスプリントを表示して)」
その他のプロンプトを試すには、エージェントの例をご覧ください。
To discover command syntax directly in the terminal, run:
twg --help
twg confluence --help
twg jira --help[更新] を選択します
Run the built-in updater:
twg updateTWG CLI checks for updates during normal use and notifies you when a new version is available.
Uninstall
Preview the files and configs that would be removed:
twg uninstall --dry-runUninstall asks for confirmation, revokes stored credentials, and removes the binary, installer-owned skill bundles, PATH changes, caches, consent, and all local TWG configs:
twg uninstallBeta updates
To receive pre-release updates before they reach the stable channel, use the beta channel.
First install via beta
bash <(curl -fsSL <https://teamwork-graph.atlassian.com/cli/beta/install)>Installs from the beta channel record the channel preference automatically — future twg update calls continue to check the beta channel.
Switch an existing install to beta
twg update --channel betaSwitch back to stable
twg update --channel stableフィードバック
フィードバックを共有したり、問題を報告したりするには、次の CLI を使用してください。
twg feedback --summary "<short title>"The command opens a prefilled public form in interactive terminals. In agent, structured-output, or non-interactive runs, it prints the form URL instead. Your configured TWG account email is prefilled when available. Review the details, provide an email if needed, complete reCAPTCHA, and submit the form. TWG authentication is not required.
You can also open the TWG CLI feedback form directly.
この内容はお役に立ちましたか?