Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
glab(1) 								 glab(1)

NAME
     glab-mr-note-create  -  Create  a comment or discussion on a merge request.
     (EXPERIMENTAL)

SYNOPSIS
     glab mr note create [ | ] [flags]

DESCRIPTION
     Add a comment to a merge request. By default, the command creates the  com-
     ment as a new discussion thread.

     Use  --resolvable=false  to  create a non-resolvable note instead.  Non-re-
     solvable notes do not block merging when the project requires  All  threads
     must  be resolved. Use this option for automation or status updates that do
     not need a human to resolve them.

     Use --reply to add a note to  an  existing  discussion  thread  instead  of
     starting  a new one. The value can be a full discussion ID or a unique pre-
     fix of at least 8 characters. Find discussion IDs with glab mr  note  list.
     Human-readable  output uses eight characters before the ellipsis, for exam-
     ple [discussion: abc12345^a|]; pass only those characters, for example --re-
     ply abc12345. To get a full ID, use the id field of each discussion object:
     glab mr note list -F json | jq -r '.[].id'.

     Use --file to place a diff comment on a specific file in the  latest  merge
     request diff version. Combine with --line (new side) or --old-line (old/re-
     moved  side)  to  target  a specific line. Omit both flags for a file-level
     comment.

     The flag rules are:

     * --line and --old-line require --file, and cannot be used together.

     * --file, --reply, and --unique are mutually exclusive.

     * --resolvable=false cannot be combined with --reply or --file (and by  ex-
       tension --line or --old-line).

     This  feature  is	an  experiment	and is not ready for production use.  It
     might be unstable or removed  at  any  time.   For  more  information,  see
     https://docs.gitlab.com/policy/development_stages_support/.

OPTIONS
     --file=""	     File  path  for  a  diff comment, like . Targets the latest
     merge request diff version.

     --line=""	    Line in the new version. A single line number, like 42, or a
     range, like 10:15.

     -m, --message=""	   Comment or note message.

     --old-line=0      Line in the old version,  for  commenting  on  a  removed
     line.

     --reply=""       Reply to an existing discussion. Accepts a full discussion
     ID or a unique prefix of at least 8 characters.

     --resolvable[=true]      Create the note as a resolvable discussion thread.
     Set to false to create a non-resolvable note.

     --unique[=false]	   Don't create a note if a note with the same body  al-
     ready exists. Reads all merge request comments first.

OPTIONS INHERITED FROM PARENT COMMANDS
     -h, --help[=false]      Show help for this command.

     -R, --repo=""	Select another repository. You can use either OWNER/REPO
     or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

EXAMPLE
     # Add a comment to merge request 123
     glab mr note create 123 -m "Looks good to me!"

     # Add a comment to the current branch's merge request
     glab mr note create -m "LGTM"

     # Open editor to compose the message
     glab mr note create 123

     # Pipe from stdin
     echo "LGTM" | glab mr note create 123

     # Read the body from a file
     glab mr note create 123 < plan.md

     # Skip if already posted
     glab mr note create 123 -m "LGTM" --unique

     # Create a non-resolvable note, for example for bot or CI status updates
     glab mr note create 123 -m "Build status: green" --resolvable=false

     # Reply to an existing discussion thread
     glab mr note create 123 --reply abc12345 -m "I agree!"

     # Add a diff comment on line 42 of main.go
     glab mr note create 123 --file main.go --line 42 -m "Needs refactoring"

     # Add a diff comment on lines 10-15 (multiline range)
     glab mr note create 123 --file main.go --line 10:15 -m "Extract this block"

     # Add a diff comment on a removed line (old side)
     glab mr note create 123 --file main.go --old-line 7 -m "Why was this removed?"

     # Add a file-level diff comment (no line specified)
     glab mr note create 123 --file main.go -m "General comment on this file"

SEE ALSO
     glab-mr-note(1)

Auto generated by spf13/cobra	    Aug 2026				 glab(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glab-mr-note-create&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help