gitlab-mr-comments

View comments and discussions on a GitLab merge request.

Extract the MR IID from the user's message (e.g. "MR 954" or "!954" → IID 954). If not provided, ask the user for the MR IID before proceeding.

Use glab CLI and jq. Must run from a git directory with GitLab remote.

Steps

1. Get MR basic info:

   glab mr view <IID> -F json
   

   Extract: title, state, author, source/target branch.

2. Get all discussion threads — pipe directly to jq, no temp files needed:

   glab api "projects/:fullpath/merge_requests/<IID>/discussions" --paginate | jq '<filter>'
   

   The glab api command handles authentication automatically. Pipe its output directly to jq for parsing.

3. Parse and classify with a single jq pipeline. Filter out system notes (where notes[0].system is true). Classify remaining into:

   • Unresolved discussions (threads where the discussion is not resolved)
   • Code-level comments (notes with position.new_path or position.old_path)
   • General comments (everything else)

   For complex jq filters, write the filter to a temp file and use jq -f /tmp/filter.jq to avoid shell quoting issues:

   # Write jq filter to file first, then:
   glab api "projects/:fullpath/merge_requests/<IID>/discussions" --paginate | jq -f /tmp/filter.jq
   

4. Present results in this order:

   MR Summary: MR — state, author, source->target

   Unresolved Discussions (show first, these need attention): For each unresolved thread:

   • If code-level: show file:line context, then the discussion thread (author, body, timestamp for each note)
   • If general: show the discussion thread

   Resolved Discussions (collapsed/summarized):

   • Count and brief summary (e.g., "12 resolved threads")
   • List one-line summaries: first note author + first ~80 chars of body

   Statistics:

   • Total discussions (excluding system notes)
   • Unresolved / Resolved count
   • Participants list

5. Suggest follow-up actions:

   • /gitlab-review-mr <IID> — do a full code review
   • glab mr note <IID> -m "..." — add a comment

IMPORTANT:

• Do NOT use interactive/TUI commands.
• Do NOT modify the MR (no approvals, no comments) unless user explicitly asks.
• Shell quoting: For complex jq filters, ALWAYS write the jq filter to a temp file (e.g. /tmp/mr_filter.jq) and use jq -f /tmp/mr_filter.jq to avoid bash interpreting special characters. NEVER use the not-equal operator with exclamation mark inline — use | not instead in jq.