Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 01 Mar 19:44
· 5 commits to main since this release

Summary

First publishable release of mdmeld — a single npm package providing a programmatic API, CLI, and static web tool for packing directory trees into markdown archives designed for AI assistant consumption.

Highlights

Core library

Browser-safe, zero Node.js dependencies. Three functions: pack(), unpack(), check(). Dual exports (ESM + CJS) with TypeScript declarations. Works identically in Node.js and the browser.

CLI

Three commands: pack (directory to archive), unpack (archive to directory), finalize (compute hashes for AI-generated archives). Supports .gitignore and .mdmeldignore patterns.

Web tool

Static single-page app with drag-and-drop folder upload, copy-to-clipboard, and download. Dark terminal-aesthetic theme. Built with Vite (61KB JS, 4KB CSS).

Archive format v1.0

Human-readable markdown with YAML frontmatter. Position metadata enables AI assistants to navigate directly to specific files. Integrity hashes (xxh64 or sha256) for verification. Backtick fence width auto-resolution (4-8).

Breaking changes

None. Initial release.

Migration

N/A — initial release.