CLI reference
This page is a reference for the commands TWG CLI agents run on your behalf. You don't need to memorize any of this — just describe what you want in plain language and your agent picks the right commands. The examples here are useful if you want to understand what's happening under the hood, write scripts, or verify agent output.
TWG CLI uses the grammar: twg <surface> <resource> <verb> [options]
Jira
twg jira workitem get PROJ-123
twg jira workitem query --jql "assignee = currentUser() AND statusCategory != Done"
twg jira workitem create --space PROJ --type Task --summary "New task"
twg jira workitem update --id PROJ-123 --summary "Updated" --status "In Progress"
twg jira workitem transition --id PROJ-123 --transition-id 31
twg jira workitem comment create --workitem-id PROJ-123 --body "Comment"
twg jira workitem link create --issue-key PROJ-1 --issue-key-linked PROJ-2 --link-type blocks
twg jira board query / get
twg jira sprint query / start
twg jira dashboard query / get
twg jira space query / get
Confluence
twg confluence page get <id>
twg confluence page create --space-id ENG --title "Title" --body "Content"
twg confluence page update <id> --title "New title" -y
twg confluence page move <id> --parent-id <parent>
twg confluence blog query / get / create
twg confluence space query / get
twg confluence search query --cql "text ~ 'onboarding'"
twg confluence database query / get
twg confluence whiteboard query / get
Bitbucket
--workspace and --repo are auto-detected from the git remote when you run from inside a repository. Supply them explicitly otherwise. twg bb is a shorthand alias for twg bitbucket.
twg bitbucket repo query # Repos in detected workspace
twg bitbucket repo get my-repo --workspace example # Explicit workspace
twg bb prs query --scope me # Your open PRs (current repo)
twg bb prs query --scope me -w atlassian # Your PRs across a workspace
twg bb prs get 42 --workspace example --repo my-repo
twg bb prs create --title "My change" --source feature/branch
twg bb prs merge 42 / decline 42 / approve 42 / unapprove 42
twg bb prs comment create 42 --text "Looks good"
twg bb prs comment update 42 <comment-id> --text "Updated"
twg bb prs comment delete 42 <comment-id>
twg bb prs task create 42 --text "Follow up on tests"
twg bb prs task resolve 42 <task-id> / reopen 42 <task-id>
twg bitbucket branch query / create
twg bitbucket commit query / get
twg bitbucket pipeline query / get
twg bitbucket deployment query / get
twg bitbucket workspace get / member query
Goals
twg goals # Active and pending goals on site
twg goals --scope me # Your goals
twg goals get <key>
twg goals --tql 'name ~ "Q2 revenue"' # Full-text search via TQL
twg goals create / update / archive
twg goals status-update create / update
Projects
twg projects # Active projects on site
twg projects --scope me # Your projects
twg projects get <key>
twg projects --tql 'name ~ "migration"' # Full-text search via TQL
twg projects create / update / archive
twg projects status-update create
Focus areas
twg focus-areas query --scope me
twg focus-areas get <ari>
twg focus-areas search "growth"
twg focus-areas-tree <ari> # Hierarchy tree by ARI
twg focus-areas-tree --name "..." # Hierarchy tree by name
Cross-product
twg work query --scope me --since 7d # Cross-product work summary
twg docs query --since 7d # Documents across all providers
twg videos query # Videos
twg meetings query --since 14d # Calendar events and recordings
twg recently-viewed # Recently viewed items
twg pull-requests <ari> # PR detail from any SCM
twg commits <ari> # Commit detail
twg deployments <ari> # Deployment detail
Identity and collaboration
twg user <account-id> # User profile
twg user search --email j@example.com # Find user by email
twg collaborators # Top collaborators (current user)
twg org-tree --up-only # Reporting chain (current user)
twg resolve --query "Jane Doe" # Resolve name or URL to ARI
twg rovo search "..." # Rovo AI search
Control plane
twg setup # Finish setup: skills, login, health check
twg login # Authenticate interactively
twg login --force # Re-enter all credentials
twg skills install --global # Repair or refresh installed agent skills
twg doctor # Check auth, connectivity, and build info
Query languages
# JQL — Jira Query Language
twg jira workitem query --jql "project = PROJ AND status = 'In Progress'"
# CQL — Confluence Query Language
twg confluence search query --cql "space = ENG AND type = page"
# TQL — Atlas Goals and Projects (use -q / --tql)
twg goals --tql "owner = currentUser() AND status = 'AT_RISK'"
# AQL — Assets Query Language
twg assets query --aql "objectType = Server AND Status = Active"