Cumul

cm is a fast CLI tool that concatenates text files in a directory into one output file, ideal for LLM context.

It respects .gitignore, skips binaries, dotfiles, and non-text formats (e.g., images).

Executable name: cm.

Installation

curl -fsSL https://raw.githubusercontent.com/xcaeser/cm/main/install.sh | bash

Updating is as simple as (linux/macos):

cm update

for windows (powershell): WIP, for now download the binary from the releases page.

Usage

Basic

cm [directory]

Generates <directory-name>-cumul.txt with file headers

running only cm scans the current directory

Options

• -p, --prefix <string>: Prefix output filename (e.g., cm -p my → my-<dir>-cumul.txt).

• -e, --exclude <string>: Comma-separated list of file names, extensions, or glob patterns (supports globs). e.g.: *.md,*.ico,src/cli/*.zig,LICENSE,

• -h, --help: Show help.

Outputs summary: files cumulated, lines, size.

Features

• Concatenates files with headers.
• Integrates .gitignore (wildcards supported).
• Filters non-text/dotfiles/output.
• Custom exclusions.

Installation from Source

zig build install

Installs cm to $HOME/.local/bin.