ACE - Bundle
Assemble multiple sources into a single bundled file, with optional compression.
Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.
Getting Started | Usage Guide | Handbook - Skills, Agents, Templates
ace-bundle assembles multiple sources — files, shell commands, and git diffs — into a single bundled file. Configure inputs through presets or frontmatter in any markdown file, with built-in support for protocol URLs (wfi://, guide://, tmpl://, prompt://, task://) resolved by ace-support-nav. Output goes to stdout or a cache file under .ace-local/bundle/, with optional compression through ace-compressor.
How It Works
- Specify inputs as preset names (
project,code-review), file paths, protocol URLs (wfi://,guide://,task://), or markdown files with frontmatter configuration. - ace-bundle resolves protocols via ace-support-nav, reads files, executes commands, generates diffs, and merges everything into structured section-based output.
- Output is delivered to stdout or saved to
.ace-local/bundle/, optionally compressed through ace-compressor for large payloads.
Use Cases
Load project context in one command — run ace-bundle project to assemble architecture docs, repository state, and command output from a single preset into a cached bundle.
Pull workflow instructions by protocol URL — run ace-bundle wfi://task/finder (or guide://..., tmpl://..., prompt://...) to resolve and load canonical handbook resources via ace-support-nav.
Bundle task context for agent workflows — run ace-bundle task://t.0or --output cache to assemble task-specific files, commands, and diffs into a single artifact for agent consumption.
Compress large bundles for LLM workflows — add --compressor on to reduce payload size through ace-compressor, with exact and agent compression modes.
Getting Started | Usage Guide | Handbook - Skills, Agents, Templates | Part of ACE