meltify

Melt files of any format into prompt-ready text where every line cites its source

Agents misread blurry digits, miss text a PDF hides, can't watch video, and paraphrase the one condition that mattered. meltify turns images, PDFs, office files, mail, video and audio into markdown an agent can quote, puts a citation on every block, and checks answers before they go out.

Quickstart

Claude Code:

/plugin marketplace add jeon-jihyeon/meltify
/plugin install meltify@meltify

Codex, Gemini CLI, Cursor and other agents that read Agent Skills:

npx skills add jeon-jihyeon/meltify

Command line only:

uvx meltify read ./inputs

The skills call the meltify command. If it isn't installed, the plugin launcher runs it through uvx, so uv is the only thing you need.

What it does

Each command has a skill of the same name, such as meltify-ocr, that tells the agent when to run it and what to do with the result.

Citations

Every result carries src and a one-line cite:

Every command prints a table by default, and the full result with --json. Exit codes:

• 0: success
• 1: violations, failed checks or other errors
• 2: usage error or bad input
• 3: a needed engine, key, binary or base module is missing

Engines

auto uses local engines only. Paid engines run only when you name them in meltify.toml or on the command line. An agent can also feed in what it reads in an image with meltify ocr --reading agent=FILE, so its own reading gets cross-checked against the local engines without any API key.

Optional parts install on request:

meltify doctor --install office      # docx, pptx and Outlook msg
meltify doctor --install media       # video URLs through yt-dlp
meltify doctor --install asr-mlx     # local speech on Apple Silicon
meltify doctor --install ocr-paddle  # PaddleOCR

media needs ffmpeg, and YouTube downloads need deno.

Configuration

Settings are layered, lowest precedence first:

1. The packaged defaults
2. $XDG_CONFIG_HOME/meltify/config.toml (usually ~/.config/meltify/config.toml)
3. The nearest meltify.toml, searched from the working directory up to the git root, or the file you pass with --config. Outside a git repository, only the working directory is searched
4. MELTIFY_<KEY> and MELTIFY_<SECTION>_<KEY> environment variables
5. Command-line flags

See examples/meltify.toml for a sample.

Limits

• Text drawn inside an image is just pixels, so hidden finds it only through --contrast rendering and OCR
• OCR agreement means the engines read the same value, not that the value is right. A value read only by LLM engines is never marked agreed
• Speech recognition and OCR quality depend on the engine and the input
• The plugin launcher is a POSIX shell script, so Windows isn't supported

License

MIT. meltify depends on PyMuPDF, which is AGPL-3.0, so distributing a product that bundles it comes with AGPL obligations.