Gage

    gage note

    The gage note command manages notes. A note is a value a scanner or person assigns to a session, session line, or other topic. For background, see Notes.

    gage note <COMMAND>

    Commands that take note IDs accept unique ID prefixes.

    note list

    List notes.

    gage note list [OPTIONS]
    OptionDescription
    -m, --moreShow more items. Repeat to show more per use.
    -a, --allShow all items
    -n, --limit <LIMIT>Limit the number of items shown (default: 20)
    --session <SESSION>Filter by target session ID (or prefix)
    --name <NAME>Filter by note name

    note show

    Show a note.

    gage note show [OPTIONS] <ID>
    OptionDescription
    -t, --targetShow target content
    -d, --docShow note docs

    note add

    Add a note of your own.

    gage note add [OPTIONS]

    The command prompts for the value when you omit --value.

    OptionDescription
    -t, --target <TARGET>Target session, as a full session ID. Append :LINE to specify a session line number.
    -n, --name <NAME>Note name (default: comment)
    -v, --value <VALUE>Note value (prompted if omitted)
    -u, --user <USER>Author username (default: $USER)

    Names need not be unique; writing the same name for the same target adds another note. See Authors and duplicate policies.

    note edit

    Edit a note.

    gage note edit [OPTIONS] <ID>
    OptionDescription
    -v, --value <VALUE>New value (prompted if omitted)

    note delete

    Delete notes.

    gage note delete [OPTIONS] [IDS]...

    In general this is not needed. Scanners benefit from keeping the note record across scans.

    OptionDescription
    -y, --yesSkip confirmation prompt