Flag	Description
`-s, --site <hostname>`	Target Atlassian site (e.g. `mycompany` or `mycompany.atlassian.net`)
`-o, --output <format>`	Output format: `text` (default) or `json`
`--scope <scope>`	Filter scope: `me`, `user`, `team`
`--since <period>`	Time window: `7d`, `2w`, `1m`, `3m`
`--first <n>`	Limit results (pagination size)
`--after <cursor>`	Pagination cursor for next page
`--account-id <aaid>`	Target user's Atlassian Account ID
`--mode agent`	Agent mode — quieter output, smaller response envelopes
`--output-file <path>`	Write JSON to file (prints `stdout=<path>` to stdout)
`--yes, -y`	Skip interactive confirmation for write operations

Site Flag

Product-specific commands (jira, confluence, bitbucket, jsm) require --site. Cross-product commands (work, goals, projects, focus-areas, org-tree) do not.

1
2
twg jira issues search --site myco --jql "project = PROJ"   # site required
twg work query --scope me --since 7d                         # no site needed

Scope and Time Filters

1
2
--scope me                   # Current user's items
--scope user --account-id X  # Specific user's items
--scope team                 # Team-level view
--since 7d                   # Last 7 days
--since 2w                   # Last 2 weeks
--since 1m                   # Last month

The --since flag uses a shorthand inspired by ISO 8601 durations: <number><unit> where unit is d (days), w (weeks), or m (months).

Pagination

1
2
--first 20                   # Return 20 results
--after <cursor>             # Next page (cursor from previous response)