Early Access Program (EAP): TWG CLI is not generally available. To request access, contact your team lead or submit a request via the EAP signup form.

Before you begin

You need macOS (arm64 or x64), Linux (x64), or Windows (arm64 or x64).
No other runtime dependencies are required.

Quick start video

Introduction to Teamwork Graph CLI 🚀 — walks through installation, authentication, and using the agent skill to query work across Atlassian products.

macOS and Linux

Run the install script:

1
2
bash <(curl -fsSL https://teamwork-graph.atlassian.com/cli/install)

The installer detects your platform, verifies the download checksum, and places the binary in ~/.local/bin.
It then runs twg login to authenticate. It also runs twg skills install to install the twg skill for your agent.
If ~/.local/bin is not in your PATH, the installer prints the exact line to add to your shell profile.

When prompted for credentials, see Authentication for instructions on creating an API token.

Homebrew (macOS)

1
2
brew tap atlassian/twg
brew install twg
twg login
twg skills install

Windows

EAP note: Windows may show a SmartScreen warning — click More info → Run anyway. This is expected for EAP. GA binaries will be signed.

Install — PowerShell

1
2
mkdir -Force "$env:LOCALAPPDATA\Programs\twg\bin" | Out-Null
Invoke-WebRequest https://teamwork-graph.atlassian.com/cli/twg-windows-x64-v0.8.0.exe -OutFile "$env:LOCALAPPDATA\Programs\twg\bin\twg.exe" -UseBasicParsing

Add to PATH, then restart PowerShell:

1
2
[Environment]::SetEnvironmentVariable("Path", "$([Environment]::GetEnvironmentVariable('Path', 'User'));$env:LOCALAPPDATA\Programs\twg\bin", "User")

Install — Command Prompt (cmd)

curl is built into Windows 10 1803 and later. If you're on an older version, use the PowerShell method above instead.

1
2
if not exist "%LOCALAPPDATA%\Programs\twg\bin" mkdir "%LOCALAPPDATA%\Programs\twg\bin"
curl -L https://teamwork-graph.atlassian.com/cli/twg-windows-x64-v0.8.0.exe -o "%LOCALAPPDATA%\Programs\twg\bin\twg.exe"

Add to PATH, then restart Command Prompt:

1
2
setx PATH "%PATH%;%LOCALAPPDATA%\Programs\twg\bin"

Once installed (either shell), run:

1
2
twg login
twg skills install

Verify the installation

1
2
twg doctor

This works the same on macOS, Linux, PowerShell, and cmd.

Update

macOS/Linux — use the built-in updater:

1
2
twg update

macOS (Homebrew):

1
2
brew update && brew upgrade twg

Windows (PowerShell or cmd) — re-run the download command from the install section above, replacing the existing .exe.

After any upgrade, re-run skill installation to pick up updated skill files:

1
2
twg skills install