SplitMerge - Guide

Split a single file into multiple files by block separators, or merge a folder of files into one. Manage bidirectional file-folder synchronization with worksets.


Getting Started

  1. Click New Workset to create a project, or use the File Split / File Merge wizards
  2. The workset editor opens with a text editor (left) and folder tree (right)
  3. Use to split editor blocks into individual files
  4. Use to merge folder files back into the editor

How It Works

Split Format

Files in the editor are separated by a configurable block format:

--------------------
path/to/file.txt
--------------------
(file content here)
  • {filepath} — the relative path for the output file
  • {filecontent} — the file content until the next separator
  • The separator format is fully customizable with presets

Split (Editor → Folder)

Parses the editor text into blocks and writes each block as a separate file to the folder.

Merge (Folder → Editor)

Reads files from the folder, wraps them in the split format, and assembles them in the editor.


Workset Editor

Text Editor (Left)

  • Displays the merged file with color-coded separators
  • Minimap sidebar showing block positions
  • Line and character count
  • Undo / Redo support

Folder Tree (Right)

  • Hierarchical view of the split folder
  • Enable/disable individual files (disabled files are skipped during split/merge)
  • Drag and drop files from Finder to add
  • Right-click for open, reflect, add, or delete operations

Compare

Click Compare to highlight differences between editor blocks and folder files. Shows file presence, content changes, and block-level mismatches.


Filters

  • File filter (include / exclude): wildcards and regex, comma-separated
  • Folder filter (include / exclude): same
  • Include subdirectories (recursive)
  • Show/hide hidden files

Keyboard Shortcuts

Main Screen

ActionShortcut
Refresh workset listCmd + R
Delete selectedDelete / Cmd + Delete

Workset Editor

ActionShortcut
Save fileCmd + S
Undo / RedoCmd + Z / Cmd + Shift + Z
CompareCmd + R
Enable selectedCmd + E
Disable selectedCmd + D
Toggle enabledCmd + T

Tips

  • Code bundling — Merge an entire source folder into one file for sharing or review, then split it back
  • Selective sync — Disable files you don't want to include in split/merge operations
  • Custom separators — Use format presets or create your own separator pattern for different file types
  • Compare before merge — Always compare first to see what has changed before overwriting

Privacy

  • All file operations run locally on your computer
  • No data is sent to any external server
  • Workset data is stored only on your local disk