omniforge

OmniForge

AI-powered merge request toolkit — review, fix, and create GitLab MRs with multi-agent intelligence

Quick Start · How It Works · MCP Tools · Contribute

---

What is OmniForge?

The merge request lifecycle has friction at every stage. Reviews are inconsistent — reviewers get tired, skip files, or rubber-stamp changes. Fixing review findings is tedious manual work. Creating MRs with proper descriptions is a chore nobody enjoys.

OmniForge automates all three stages. It is a unified Claude Code plugin that covers the full MR lifecycle: multi-agent adversarial review, automated finding resolution, and MR creation with auto-populated metadata. Three skills, one plugin, zero context switching.

Included Skills

Skill	Command	Description
OmniReview	/omnireview-gitlab	Multi-agent adversarial MR review with 3 parallel agents, confidence scoring, and cross-correlation
OmniFix	/omnifix-gitlab	Automated finding fixer — triages, applies fixes, verifies, commits, and resolves discussion threads
OmniCreate	/omnicreate-gitlab	MR creation with auto-populated title and description from commit history

---

Quick Start

Prerequisites

1. Claude Code installed and working (get it here)
2. uv (Python package runner) — required for the MCP tool server:

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Or via Homebrew (macOS)
   brew install uv
   
   # Verify
   uv --version
   

   The MCP server uses uv run --with mcp[cli] to auto-resolve Python dependencies at runtime — no manual pip install needed.
3. glab CLI — required for GitLab MR operations:

   # macOS
   brew install glab
   
   # Linux — see https://gitlab.com/gitlab-org/cli#installation
   
   # Authenticate
   glab auth login
   

4. Git (version 2.15+ for worktree support)
5. A GitLab repository cloned locally

Installation

Option A: Install as Plugin (Recommended)

Two commands in your terminal (outside Claude Code):

# 1. Add OmniForge as a marketplace source
claude plugin marketplace add https://github.com/nexiouscaliver/OmniForge.git

# 2. Install the plugin
claude plugin install omniforge@omniforge-marketplace

This installs all three skills, the MCP server, and all agent templates in one step. Claude Code manages updates and uninstall automatically.

To update later:

claude plugin marketplace update omniforge-marketplace
claude plugin update omniforge

To uninstall:

claude plugin uninstall omniforge
claude plugin marketplace remove omniforge-marketplace

Option B: Load from Local Directory (Development/Testing)

If you have cloned the repo locally and want to test without installing:

claude --plugin-dir /path/to/OmniForge/plugins/omniforge

Option C: Manual Personal Skill (No MCP Server)

If you prefer a manual installation as a personal skill (without the MCP tool server):

# 1. Clone the repository
git clone https://github.com/nexiouscaliver/OmniForge.git

# 2. Install the review skill
mkdir -p ~/.claude/skills/omnireview-gitlab/references
cp OmniForge/plugins/omniforge/skills/omnireview-gitlab/SKILL.md ~/.claude/skills/omnireview-gitlab/
cp OmniForge/plugins/omniforge/skills/omnireview-gitlab/references/* ~/.claude/skills/omnireview-gitlab/references/

# 3. Install OmniFix (fix skill)
mkdir -p ~/.claude/skills/omnifix-gitlab/references
cp OmniForge/plugins/omniforge/skills/omnifix-gitlab/SKILL.md ~/.claude/skills/omnifix-gitlab/
cp OmniForge/plugins/omniforge/skills/omnifix-gitlab/references/* ~/.claude/skills/omnifix-gitlab/references/