patch-resolve

A CLI tool for patching files and resolving file includes - designed to make working with LLMs easier.

Installation

npm install -g patch-resolve
# or
bun add -g patch-resolve

Commands

patch

Apply file contents from a patch file with special marker separators to their respective files.

patch-resolve patch <file>

The patch file uses the separator format: --- <path>:

Example patch file:

--- src/index.ts:
export const foo = 'bar';

--- src/utils.ts:
export function helper() {
  return 'hello';
}

This will:

• Create/overwrite src/index.ts with export const foo = 'bar';
• Create/overwrite src/utils.ts with the helper function
• Create parent directories if they don't exist

resolve

Resolve file includes and copy to clipboard, also write to temp file.

patch-resolve resolve <file>

The resolve file uses include patterns like {{path/to/file}}.

Example resolve file:

// Main application code
{{shared/config.ts}}
{{api/endpoints.ts}}

This will:

• Read shared/config.ts and replace {{shared/config.ts}} with its content
• Read api/endpoints.ts and replace {{api/endpoints.ts}} with its content
• Write the resolved content to a temp file
• Copy to clipboard (by default)

Options:

• -p, --pattern <pattern> - Custom include pattern
• -o, --output <path> - Custom output path
• --no-clipboard - Skip copying to clipboard

Use Cases

1. With LLMs: LLMs can output patch files with --- <path>: separators, and you can apply them with one command
2. With LLMs: LLMs can reference multiple files using {{path}} patterns, and you can resolve them into a single file
3. File batch operations: Apply multiple file changes at once from a single patch file

License

MIT