• 関連ドキュメント

TWG CLI をセットアップする

現在、このエクスペリエンスはベータ版です。

Teamwork Graph (TWG) CLI のセットアップは、インストール、認証、エージェント スキルの追加の 3 つのステップで行います。最終的には、AI コーディング エージェントがアトラシアンのデータ (Jira 課題、Confluence ページ、Bitbucket リポジトリなど) に完全にアクセスできるようになります。これにより、コマンド構文を使用せずに平易な英語で作業を照会および管理できます。

はじめる前に

  • macOS (arm64 または x64)、Linux (x64)、または Windows (arm64 または x64) が必要です。

  • 使用する製品にアクセスできる Atlassian アカウントが必要です。

  • ご利用のコンピューターに AI コーディング エージェントをインストールする必要があります。サポートされているエージェントのリストについては、TWG CLI とはをご覧ください。

ステップ 1: AI コーディング エージェントをインストールする

TWG CLI は任意の AI コーディング エージェントと連携します。エージェントがインストールされていない場合は、続行する前に、選択したエージェントのドキュメントに記載されているセットアップ手順に従ってください。

ステップ 2: TWG CLI をインストールする

macOS および Linux

次のインストール スクリプトを実行します。

curl -fsSL https://teamwork-graph.atlassian.com/cli/install | bash

インストーラーがプラットフォームを検出し、ダウンロードのチェックサムを検証し、バイナリを ~/.local/bin にインストールし、初回の同意を求め、TWG エージェントのスキルをインストールし、コマンド ヘルプを更新して、認証を開始します。

同意が必要な場合は、yes、continue、または no と回答します。その後、次の操作を行います。

  • インストーラーのトークン ページが開きます。ブラウザでトークンを生成してコピーし、Enter キーを押します。インストーラーが OS のクリップボードからそれを読み取ります。クリップボードへのアクセスが利用できない場合は、マスクされた貼り付けプロンプトにフォールバックします。

  • Bitbucket トークンがまだ設定されていない場合は、オプションの Bitbucket トークンに対して同じクリップボード確認フローが提供されます。

  • バイナリがクラシック API トークン モードを使用している場合、クラシック トークン単独ではアカウントを識別できないため、Atlassian アカウントのメール アドレスも求められます。

  • クリップボード履歴マネージャーを使用している場合は、セットアップ後に履歴をクリアしてください。

エージェント セッションで実行している場合は、代わりに https://teamwork-graph.atlassian.com/cli/AGENTS.md でホストされている手順に従って、同意とトークンのハンドオフを行ってください。

インストーラーが自動でセットアップを完了します。後でセットアップを修復するには、次の手順に従います。

twg setup

特定のバージョンをインストールするには、次の手順に従います。

curl -fsSL https://teamwork-graph.atlassian.com/cli/install | bash -s -- --version 0.9.1

PATH に ~/.local/bin が含まれていない場合は、シェル プロファイルに追加する正確な行が出力されます。

Homebrew (macOS)

brew tap atlassian/twg brew install twg twg setup

Windows

Windows: インストーラーについて SmartScreen の警告が表示された場合は、[詳細情報] > [実行] の順に選択してください。リリース前のビルドでは、本番環境のコード署名がまだ使用されていない場合があります。これは、一般提供される署名付きバイナリがリリースされるまでは想定される挙動です。

インストール - PowerShell

irm https://teamwork-graph.atlassian.com/cli/install.ps1 | iex

インストール - コマンド プロンプト (cmd)

curl は Windows 10 1803 以降に組み込まれています。古いバージョンを使用している場合は、代わりに上記の PowerShell による方法を使用してください。

powershell -ExecutionPolicy Bypass -Command "irm https://teamwork-graph.atlassian.com/cli/install.ps1 | iex"

Windows インストーラーは、macOS や Linux と同じセットアップ (バイナリのインストール、チェックサムの検証、スキルのインストール、ヘルプの更新、トークンによるログイン) を実行します。

コーディング エージェントを使用してインストールする

コーディング エージェントに TWG CLI をインストールするよう依頼できます。次のプロンプトをコピーして、エージェントに貼り付けてください。

Install and set up TWG CLI for me using the official agent instructions at https://teamwork-graph.atlassian.com/cli/AGENTS.md

エージェントがインストーラーをダウンロードし、チェックサムを検証し、バイナリをインストールして、認証とスキルのセットアップを自動で完了します。セットアップを確認するに進んでください。

ステップ 3: 認証する

次のコマンドを実行し、プロンプトに従います。

twg login

次の情報を求められます。

プロンプト

入力する内容

メール

Atlassian アカウントのメール アドレス。クラシック API トークンの場合は必須です。スコープ付きトークンによるログインでは推測される場合があります。

トークン

twg login から自動で開くページに表示されるトークン。

Bitbucket トークン

オプション。Bitbucket 固有のコマンドにのみ必要です。

サイト

Atlassian サイト名 (例: example.atlassian.net の場合は example)。自動で選択される場合があります。

認証情報は ~/.twg/auth.conf に保存され、毎回再利用されます。任意の時点で更新するには、twg login --force を実行してください。

API トークンを手動で作成する

twg login を実行すると、ブラウザが自動で開き、トークン作成ページが表示されます。トークンを手動で作成する必要がある場合は、次の手順に従います。

  1. https://id.atlassian.com/manage-profile/security/api-tokens にアクセスします。

  2. [スコープ付き API トークンを作成] をクリックして、事前に入力された設定を承認します。

  3. トークンの値をコピーして、twg login のプロンプトが表示されたら貼り付けます。

Bitbucket 固有のコマンドには、別個の Bitbucket トークンが必要です。twg login にはこのオプションのトークンを求めるプロンプトが表示され、twg login --force を実行しない限り既存のトークンが保持されます。

環境変数を使用する (CI/CD)

CI/CD パイプラインやスクリプトで使用する場合は、twg login を実行する代わりに次の変数を設定します。

変数

目的

TWG_USER

Atlassian アカウントのメール アドレス

TWG_SITE

既定のサイト プレフィックス

TWG_TOKEN

ログイン トークン ページで生成された API トークン

TWG_BBC_TOKEN

Bitbucket 固有のコマンド用の Bitbucket トークン

トークンを CLI のフラグとして渡さないでください。TWG CLI は、対話形式または環境変数経由でのみ認証情報を受け付けます。

セットアップを確認する

次のコマンドを実行します。

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 (チームの現在のスプリントを表示して)」

その他のプロンプトを試すには、エージェントの例をご覧ください。

[更新] を選択します

macOS/Linux - 組み込みのアップデーターを使用してください。

twg update

macOS (Homebrew):

brew update && brew upgrade twg

Windows (PowerShell または cmd) - 上記の Windows セクションのインストール コマンドを再実行してください。

twg update およびインストーラーは、既存の TWG スキルのインストールを検出すると、インストール済みのスキル ファイルを自動で更新します。

フィードバック

フィードバックを共有したり、問題を報告したりするには、次の CLI を使用してください。

twg feedback --summary "short title"

または、TWG CLI フィードバック フォームを使用してフィードバックを送信してください。

結果

TWG CLI のインストールと設定が正常に完了しました。これで、AI コーディング エージェントが Jira、Confluence、Bitbucket などのアトラシアンのデータに接続され、アクセスできるようになりました。エージェントに実現したいことを自然な言葉で説明するだけで、あとはエージェントが処理します。

 

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

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容はじめる前にステップ 1: AI コーディング エージェントをインストールするステップ 2: TWG CLI をインストールするmacOS および LinuxWindowsコーディング エージェントを使用してインストールするステップ 3: 認証するAPI トークンを手動で作成する環境変数を使用する (CI/CD)セットアップを確認するトライアル[更新] を選択しますフィードバック結果
コミュニティ質問、ディスカッション、記事