| GT-NOTIFICATION-LIST(1) | gitea-cli Manual | GT-NOTIFICATION-LIST(1) |
NAME
gt-notification-list - List notifications
SYNOPSIS
gt notification list [flags]
DESCRIPTION
List notifications
JSON FIELDS
id, number, pinned, repository, state, title, type, unread, updated_at, url
OPTIONS
-h, --help[=false] help for list
-L, --limit=30 Maximum number of results (1..1000)
--page=1 Result page
--since="" Only notifications updated since a date, timestamp, or duration such as 24h
--status=[unread,pinned] Only notifications with these statuses: unread, read, pinned
--type=[] Only notifications about these subjects: issue, pull, commit, repository
--until="" Only notifications updated before a date, timestamp, or duration such as 1h
OPTIONS INHERITED FROM PARENT COMMANDS
--csv[=""] Output CSV with the specified comma-separated fields, or all fields
--cwd="" Working directory for repository discovery
--debug[=false] Log the method, URL, status, and duration of each HTTP request to stderr
--host="" Gitea instance URL, including any base path
--interactive[=false] Allow prompts with machine output
-q, --jq="" Filter JSON output using a jq expression; implies --json
--json[=""] Output JSON with the specified comma-separated fields, or all fields
--no-input[=false] Disable prompts and implicit editor/browser interactions
--remote="" Git remote used for repository discovery
-R, --repo="" Select a repository as OWNER/REPO or URL
--sudo="" Perform API requests as this user (requires an administrator account)
--this-repo[=false] Only notifications of the repository in the current directory
--user="" Account name on the selected instance
EXAMPLE
$ gt notification list # Including the ones you read, of one repository $ gt notification list --status unread,read,pinned -R alice/project # Pull requests updated today $ gt notification list --type pull --since 24h
SEE ALSO
| Nov 2026 | gitea-cli |