---

name: mpatch version: 1.0.0 description: Use when applying unified diff patches via CLI with fuzzy matching for out-of-date patches author: pe200012 license: BSD-3-Clause tags: [git, patch, diff, cli, tool]

mpatch Skill

Smart context-aware CLI tool for applying unified diffs with fuzzy matching.

When to Use

• Applying unified diff patches to source files via command line
• Patches where line numbers may be outdated
• Fuzzy matching patches against modified content
• Processing Markdown diff blocks, unified diffs, or conflict markers

Installation

Copycargo install mpatch

CLI Usage

Basic Syntax

Copympatch <INPUT_FILE> <TARGET_DIR>

Arguments

Options

Examples

Apply a patch

Copympatch changes.patch ./src

Dry run (preview changes)

Copympatch -n changes.patch ./src

Strict matching (no fuzzy)

Copympatch -f 0 changes.patch ./src

Lenient fuzzy matching

Copympatch -f 0.5 changes.patch ./src

Verbose output for debugging

Copympatch -vv changes.patch ./src

Supported Patch Formats

mpatch auto-detects the input format:

1. Unified Diff (standard diff -u output)

   Copy--- a/file.txt
   +++ b/file.txt
   @@ -1,3 +1,4 @@
    line1
   +new line
    line2
   

2. Markdown Code Blocks (common in AI-generated patches)

   Copy```diff
   --- a/file.txt
   +++ b/file.txt
   @@ -1,3 +1,4 @@
    context
   -old
   +new
   ```
   

3. Conflict Markers (git merge conflicts)

   Copy<<<<<<< HEAD
   current content
   =======
   incoming content
   >>>>>>> branch
   

Key Features

• Ignores line numbers: Uses context matching instead
• Fuzzy matching: Applies patches even when source has minor changes
• Auto-detection: No need to specify patch format
• Smart indentation: Handles indentation differences

Common Mistakes

Workflow Example

Copy# 1. Preview what will change
mpatch -n patch.diff ./myproject

# 2. Apply with verbose output
mpatch -v patch.diff ./myproject

# 3. If fuzzy fails, try more lenient
mpatch -f 0.5 patch.diff ./myproject