
Gfreview
- 3 installs
- Updated April 6, 2026
- martinffx/gfreview
Helps with ai & agent building tasks.
About
gfreview is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.
- gfreview
- AI & Agent Building
- AI-coding skill
Gfreview by the numbers
- 3 all-time installs (skills.sh)
- Ranked #13,657 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Jul 25, 2026 (Skillselion catalog sync)
npx skills add https://github.com/martinffx/gfreview --skill gfreviewAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 3 |
|---|---|
| Last updated | April 6, 2026 |
| Repository | martinffx/gfreview ↗ |
What it does
Helps with ai & agent building tasks.
Files
gfreview
CLI tool for interacting with GitHub PRs and GitLab MRs from the terminal.
Configuration
| Variable | Description |
|---|---|
| GITHUB_TOKEN | GitHub PAT |
| GITLAB_TOKEN | GitLab token |
| GITLAB_URL | GitLab URL (default: https://gitlab.com) |
CLI flags: --forge github|gitlab, --project owner/repo, --token
Commands
PR Listing
gfreview list [--state open|closed|all] [--limit n]
gfreview view <id>PR Creation
gfreview create --title <title> --source-branch <branch> --target-branch <branch> [--description <text>] [--draft]PR Actions
gfreview approve <id>
gfreview merge <id>Immediate Comments (No Review Session)
Post comments immediately without starting a review session.
gfreview post <id> --file <path> --line <n> --body <text> # Line comment
gfreview post <id> --body <text> # General comment
gfreview post <id> --file <path> --line <n> --severity blocker --body <text>
gfreview post <id> --file <path> --line <n> --body-file <path>Batched Review (Start → Comment → Submit)
Comments grouped in one review with a summary.
gfreview review start <id> # Create pending review
gfreview review comment <id> --file <path> --line <n> --body <text> # Add to pending review
gfreview review submit <id> [--body <summary>] # Submit review
gfreview review status <id> # Show pending comments
gfreview review discard <id> # Delete pending reviewDiff & Comments
gfreview diff <id> # Show diff with line numbers
gfreview comments <id> # List posted commentsOptions
| Flag | Description |
|---|---|
--body <text> | Comment body (use @path for file, - for stdin) |
--body-file <path> | Read body from file |
--severity | blocker, issue, suggestion, nit |
--side | new (default) or old |
--json | JSON output |
--verbose | Verbose output |
Severity Levels
Use --severity to categorize line comments:
| Level | Description |
|---|---|
| blocker | Must be fixed before merge |
| issue | Should be addressed before merge |
| suggestion | Optional improvement |
| nit | Minor style suggestion |
Severity is prepended to the comment body.
Line Number Mapping
For --line, use numbers from gfreview diff <id>:
| Diff prefix | Side |
|---|---|
- (red) | old |
+ (green) | new |
| space | new |
Body Input
--body "inline text"
--body @/path/to/file.md
--body-file /path/to/file.md
cat file.md | gfreview post <id> --file <path> --line <n> --body -Error Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | User error (invalid input) |
| 2 | API error |
| 3 | Stale review |
Forge Differences
| Aspect | GitHub | GitLab |
|---|---|---|
| Line comments | Comments API | Discussions API |
| General comments | Issues API | Notes API |
| Review batching | Pending reviews | Draft notes |
gfreview Commands
PR Management
| Command | Description |
|---|---|
| `list [--state open\ | closed\ |
view <id> | Show PR details |
create --title <t> --source-branch <s> --target-branch <t> | Create PR |
approve <id> | Approve PR |
merge <id> | Merge PR |
Immediate Comments (No Review Session)
Post comments directly without batching.
| Command | Description |
|---|---|
post <id> --file <path> --line <n> --body <text> | Line comment |
post <id> --body <text> | General comment |
post <id> --file <path> --line <n> --severity blocker --body <text> | With severity |
post <id> --file <path> --line <n> --body-file <path> | Body from file |
Batched Review
Group comments in one review with a summary.
| Command | Description |
|---|---|
review start <id> | Create pending review |
review comment <id> --file <path> --line <n> --body <text> | Add to pending review |
review status <id> | Show pending comments |
review submit <id> [--body <summary>] | Submit review |
review discard <id> | Delete pending review |
Diff & Comments
| Command | Description |
|---|---|
diff <id> | Show diff with line numbers |
comments <id> | List posted comments |
Options
| Flag | Description |
|---|---|
--body <text> | Comment body |
--body @path | Body from file |
--body-file <path> | Body from file |
| `--severity blocker\ | issue\ |
| `--side new\ | old` |
--json | JSON output |
--verbose | Verbose output |
| `--forge github\ | gitlab` |
--project <owner/repo> | Override project |