misa
Fast-decompress LZ codec CLI for write-once, read-many data
TLDR
SYNOPSIS
misa compress | decompress | suggest [options] FILE
DESCRIPTION
misa is the command-line front end for misa77, an LZ-based lossless compression codec aimed at write-once, read-many workloads. It prioritizes very high single-threaded decompression throughput and modest ratios (comparable to high-effort LZ4), at the cost of slower compression. Memory use is bounded: at most about 5 MB across compression modes, and effectively none for decompression.The CLI works on single files only (no directory recursion or pipe/streaming support). Archive archives as `.misa77`; parameter vectors from `suggest` use `.misap`. Compression level 0 favors decode speed; level 1 (default) favors ratio with similar encode throughput. Experimental flags such as --adaptive, --params, and --yolo offer decode-optimized or autotuned modes and must not be combined with each other or with --level.misa77 requires a little-endian 64-bit system and a C++20 toolchain to build. The stream format may change while the project is pre-1.0; invalid input is treated as undefined behavior and the tool is experimental.
PARAMETERS
compress FILE
Compress FILE to FILE.misa77 (or -o path).decompress FILE.misa77
Decompress a misa77 archive back to the original name (or -o path).suggest FILE
Sample the input and write a tuned params file (FILE.misap) for later --params use.-l N, --level N
Compression level for compress (0 = fastest decode, 1 = default better ratio).-o PATH
Output path.-f
Overwrite existing output without prompting.--adaptive
Autotune compression for decode speed (best on homogeneous data); experimental; not combinable with --level.--params FILE.misap
Compress with parameters from misa suggest; experimental; not combinable with --level.--yolo
High-effort, decode-optimized experimental mode; not combinable with --level.--tune loose|tight
Tradeoff for --adaptive / suggest (similar to levels 0/1; default loose).--sample MB
How much input to sample when picking params (default 2 MB).
CAVEATS
File-based only: use tar (or similar) first for directories or multi-file bundles. Format may change in 0.x releases. The decoder assumes valid misa77 input; corrupted streams are not hardened. Prefer misa for cold storage and read-heavy archives where decompression speed matters more than encode time or maximum ratio.
