Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Apr 17, 2026

Authentication

Log in

Run the following command and follow the prompts:

1
2
twg login

You'll be asked for:

PromptWhat to enter
SiteYour Atlassian site name (for example, example for example.atlassian.net)
EmailYour Atlassian account email
API tokenA classic (unscoped) API token — see below

Credentials are saved to ~/.twg/auth.conf and reused across sessions.

Create an API token

TWG CLI requires a classic API token (also called an unscoped token).

  1. Go to your Atlassian API tokens page.
  2. Click Create API token — this is the first option on the page. Use the classic (unscoped) token option, not Create API token with scopes.
  3. Give it a label such as twg-cli and copy the token value.

Set up optional product tokens

Some products require additional credentials. All are prompted interactively during twg login:

ProductWhat you need
BitbucketBitbucket app password
Rovo SearchMCP-scoped token

Use environment variables

For CI/CD and scripted use, set the following variables instead of running twg login:

VariablePurpose
TWG_USERAtlassian account email
TWG_SITEDefault site prefix
TWG_TOKENClassic API token
TWG_BBC_TOKENBitbucket app password
TWG_MCP_TOKENRovo MCP token

Never pass tokens as CLI flags. TWG CLI only accepts credentials interactively or via environment variables.

Next steps

Rate this page: