GitLab API Skill

Node.js client for the GitLab REST API (v4). Reads config from ./.env.

Security Rules

• - NEVER read, cat, print, grep, or expose the GITLAB_TOKEN value.
• NEVER use curl, wget, or any tool to call GitLab API directly. All access MUST go through gitlab-client.
• AI may read/write .env to manage GITLAB_URL, but GITLAB_TOKEN must be set by the user manually.

Setup

Requires ./.env with:

CODEBLOCK0

If token is missing, prompt the user to edit ./.env and create a token at <GITLAB_URL>/-/profile/personal_access_tokens (scope: api).

Install (first time): INLINECODE11

Quick Start

CODEBLOCK1

Commands Reference

Format: INLINECODE12

All list actions support --page N --per-page N (default 20, max 100).

Projects

Action	Usage	Options
list	INLINECODE14	INLINECODE15
get

projects get <id> | | | search | projects search "term" | | | create | projects create --name "name" | --description --visibility --namespace-id --initialize-with-readme | | edit | projects edit <id> | --name --description --visibility | | delete | projects delete <id> | | | fork | projects fork <id> | --namespace | | members | projects members <id> | | | hooks | projects hooks <id> | |

Issues

Action	Usage	Options
list	INLINECODE27	INLINECODE28
get

issues get --project <id> --iid <iid> | | | create | issues create --project <id> --title "T" | --description --labels --assignee-ids --milestone-id --due-date --confidential | | edit | issues edit --project <id> --iid <iid> | --title --description --state-event --labels --assignee-ids | | close | issues close --project <id> --iid <iid> | | | reopen | issues reopen --project <id> --iid <iid> | | | delete | issues delete --project <id> --iid <iid> | | | notes | issues notes --project <id> --iid <iid> | | | add-note | issues add-note --project <id> --iid <iid> --body "text" | |

Merge Requests

Action	Usage	Options
list	INLINECODE39	INLINECODE40
get

mrs get --project <id> --iid <iid> | | | create | mrs create --project <id> --source-branch "src" --target-branch "tgt" --title "T" | --description --assignee-id --reviewer-ids --labels --milestone-id --remove-source-branch --squash | | edit | mrs edit --project <id> --iid <iid> | --title --description --state-event --labels --assignee-id | | merge | mrs merge --project <id> --iid <iid> | --merge-commit-message --squash --should-remove-source-branch | | changes | mrs changes --project <id> --iid <iid> | | | commits | mrs commits --project <id> --iid <iid> | | | notes | mrs notes --project <id> --iid <iid> | | | add-note | mrs add-note --project <id> --iid <iid> --body "text" | | | approve | mrs approve --project <id> --iid <iid> | | | pipelines | mrs pipelines --project <id> --iid <iid> | |

Branches

Action	Usage	Options
list	INLINECODE54	INLINECODE55
get

branches get --project <id> --branch "name" | | | create | branches create --project <id> --branch "name" --ref "main" | | | delete | branches delete --project <id> --branch "name" | | | delete-merged | branches delete-merged --project <id> | |

Commits

Action	Usage	Options
list	INLINECODE60	INLINECODE61
get

commits get --project <id> --sha "abc123" | | | diff | commits diff --project <id> --sha "abc123" | | | comments | commits comments --project <id> --sha "abc123" | | | add-comment | commits add-comment --project <id> --sha "abc123" --note "text" | |

Repository / Files

Action	Usage	Options
tree	INLINECODE66	INLINECODE67
file

repo file --project <id> --file-path "path" | --ref | | raw | repo raw --project <id> --file-path "path" | --ref | | create-file | repo create-file --project <id> --file-path "p" --branch "b" --content "c" --commit-message "m" | | | update-file | repo update-file --project <id> --file-path "p" --branch "b" --content "c" --commit-message "m" | | | delete-file | repo delete-file --project <id> --file-path "p" --branch "b" --commit-message "m" | | | compare | repo compare --project <id> --from "main" --to "feat" | |

Pipelines

Action	Usage	Options
list	INLINECODE76	INLINECODE77
get

pipelines get --project <id> --pipeline-id <pid> | | | jobs | pipelines jobs --project <id> --pipeline-id <pid> | | | job-log | pipelines job-log --project <id> --job-id <jid> | | | retry | pipelines retry --project <id> --pipeline-id <pid> | | | cancel | pipelines cancel --project <id> --pipeline-id <pid> | | | create | pipelines create --project <id> --ref "main" | --variables "K1=v1,K2=v2" |

Groups

Action	Usage	Options
list	INLINECODE85	INLINECODE86
get

groups get <id> | | | projects | groups projects <id> | --search | | members | groups members <id> | | | issues | groups issues <id> | --state | | mrs | groups mrs <id> | --state |

Users

Action	Usage
me	INLINECODE95
list

users list [--search "john"] | | get | users get <id> | | projects | users projects <id> |

Labels

Action	Usage	Options
list	INLINECODE99
create

labels create --project <id> --name "bug" --color "#FF0000" | --description | | edit | labels edit --project <id> --name "bug" | --new-name --color | | delete | labels delete --project <id> --name "bug" | |

Milestones

Action	Usage	Options
list	INLINECODE105	INLINECODE106
get

milestones get --project <id> --milestone-id <mid> | | | create | milestones create --project <id> --title "v1.0" | --description --due-date --start-date | | edit | milestones edit --project <id> --milestone-id <mid> | --title --state-event | | delete | milestones delete --project <id> --milestone-id <mid> | |

Tags & Releases

Action	Usage	Options
tags list	INLINECODE113	INLINECODE114
tags create

tags create --project <id> --tag-name "v1.0" --ref "main" | --message | | tags delete | tags delete --project <id> --tag-name "v1.0" | | | releases list | releases list --project <id> | | | releases create | releases create --project <id> --tag-name "v1.0" --name "R1" | --description |

Snippets

Action	Usage	Options
list	INLINECODE121
get

snippets get --project <id> --snippet-id <sid> | | | create | snippets create --project <id> --title "T" --file-name "f" --content "c" | --visibility |

Search

Action	Usage
global	INLINECODE125
project

search project --project <id> --scope <scope> --search "query" | | group | search group --group <id> --scope <scope> --search "query" |

Scopes — global: projects|issues|merge_requests|milestones|snippet_titles|users. Project: issues|merge_requests|milestones|notes|wiki_blobs|commits|blobs. Group: projects|issues|merge_requests|milestones.

Runners

Action	Usage	Options
list	INLINECODE131
all

runners all | --type --status |

Webhooks

Action	Usage	Options
list	INLINECODE134
create

hooks create --project <id> --url "url" | --push-events --merge-requests-events --issues-events --token | | delete | hooks delete --project <id> --hook-id <hid> | |

Usage Notes

• - Auth: Uses PRIVATE-TOKEN header. Scopes: api (full), read_api (read-only), read_user, read_repository.
• Project ID: Use numeric ID or URL-encoded path (my-group%2Fmy-project).
• Output: JSON. Pipe to jq for filtering: INLINECODE145
• Dates: ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
• Labels: Comma-separated: --labels "bug,feature,urgent".
• Errors: 401 unauthorized, 403 forbidden, 404 not found, 422 validation, 429 rate limited.