Loomer

Merge multiple files into one AI-friendly document. Loomer normalizes structure across Markdown, HTML, JSON, YAML, and plain text so models can see context in a single pass.

Installation

Using npx (no installation required)

npx loomer merge notes.md data.json --out merged.md

Global installation

npm install -g loomer
loomer merge notes.md data.json --out merged.md

Local installation

npm install loomer
npx loomer merge notes.md data.json --out merged.md

Usage

Merge files in order and write the output:

loomer merge notes.md data.json --out merged.md

No --out? Loomer writes merged.md in the current directory by default.

Merge everything in a folder (recursive, supported file types only):

loomer merge docs/ --out combined.txt

Merge as plain text:

loomer merge a.txt b.yaml --format text

Render as HTML:

loomer merge docs/ --format html --out merged.html

Every merged file is prefixed with its path for clarity:

---
/public/article.md
---
<file contents...>

Inspect how Loomer sees a file:

loomer inspect README.md

Show version:

loomer version

Options

• --out to write to a file (otherwise prints to stdout)
• --format choose markdown, text, html, or json (defaults to markdown or derived from --out)
• --metadata include parsed metadata in the merged output
• --optimize enable text optimization (collapse excess whitespace, normalize indentation; code fences are preserved)

Development

Requirements

• Bun >= 1.0

Setup

git clone https://github.com/minagishl/loomer.git
cd loomer
bun install

Build

bun run build

Run locally

bun run dev

Tests

bun test

Linting and Formatting

bun run lint          # Check for linting errors
bun run lint:fix      # Fix linting errors
bun run format        # Check code formatting
bun run format:write  # Fix code formatting

Project Structure

• src/core parsers, normalization, merger
• src/cli CLI wiring for merge/inspect/version commands
• src/utils shared helpers
• src/index.ts CLI entrypoint

License

This project is licensed under the MIT License - see the LICENSE file for details.