Gage

    gage issue

    The gage issue command manages issues. An issue is a finding reported by a scanner or added by you. For background, see Issues.

    gage issue <COMMAND>

    Commands that take issue IDs accept unique ID prefixes. Commands that modify issues prompt for confirmation. Use --yes to skip the prompt.

    issue list

    List issues.

    gage issue list [OPTIONS]

    The command shows open issues, newest first, up to a default limit of 20.

    OptionDescription
    -m, --moreShow more items. Repeat to show more per use.
    -a, --allShow all items
    -n, --limit <N>Limit the number of items shown (default: 20)
    --name <NAME>Filter by issue name
    -c, --closedShow closed issues

    issue show

    Show an issue.

    gage issue show <ID>

    The command prints the issue description, its supporting evidence, and its event history. Events include status changes and comments.

    issue add

    Add an issue of your own.

    gage issue add [OPTIONS]

    The command prompts for a title and description when you omit them.

    OptionDescription
    -t, --title <TITLE>Title (prompted if omitted)
    -d, --description <DESCRIPTION>Description (prompted if omitted)
    -n, --name <NAME>Issue name (default: user-issue)
    -p, --pendingAdd as pending instead of the default open

    issue close

    Close one or more issues.

    gage issue close [OPTIONS] [IDS]...

    A close marks the issue completed by default. Use --skipped to record it as a non-issue. Use --duplicate when another issue already covers it.

    OptionDescription
    -s, --skippedClose as skipped instead of the default completed
    -d, --duplicateClose as duplicate instead of the default completed
    -m, --message <MESSAGE>Message explaining the close
    -y, --yesSkip confirmation prompt

    issue open

    Open pending or closed issues.

    gage issue open [OPTIONS] [IDS]...
    OptionDescription
    -m, --message <MESSAGE>Message explaining the open
    -y, --yesSkip confirmation prompt

    issue comment

    Comment on issues.

    gage issue comment [OPTIONS] [IDS]...

    The command prompts for the comment text when you omit --message. Comments appear in the issue’s event history in gage issue show.

    OptionDescription
    -m, --message <MESSAGE>Comment text (prompted if omitted)
    -y, --yesSkip confirmation prompt

    issue delete

    Delete issues.

    gage issue delete [OPTIONS] [IDS]...

    A delete removes the issue record. To dismiss a finding while keeping its record, close the issue instead.

    OptionDescription
    -y, --yesSkip confirmation prompt