# X07 Bundle

> Produce distributable native executables (normal CLI ABI) via `x07 bundle`. Use when this capability is needed.

- Skill: `tomevault-io/x07-bundle` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/x07-bundle`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/x07-bundle/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/x07-bundle

---


# x07-bundle

Use `x07 bundle` to produce a native executable that can be run directly on the target machine without the X07 toolchain installed at runtime.

`x07 bundle` runs the canonical auto-repair loop by default (`--repair=...`), so it can format/lint/apply quickfixes before compiling. Use `--repair=off` when debugging.

## Canonical commands

- Bundle an OS-world CLI executable:
  - `x07 bundle --project x07.json --profile os --out dist/app`
  - run it: `./dist/app --help`
  - if bundling fails with `fuel exhausted`, override:
    - `x07 bundle --project x07.json --profile os --solve-fuel 500000000 --out dist/app`

- Bundle a policy-enforced OS-world executable:
  - `x07 bundle --project x07.json --profile sandbox --out dist/app`
  - requires a base policy (via `profiles.sandbox.policy` or `--policy`)

## Runtime ABI

The bundled executable:

- reads standard process args (`argc/argv`)
- encodes them into `argv_v1` input bytes
- calls the compiled program entrypoint (`x07_solve_v2`)
- writes program output bytes directly to stdout (no framing)

## Emit artifacts (debug / CI)

- `x07 bundle ... --emit-dir dist/emit`
  - emits `report.json`, `program.freestanding.c`, `wrapper.main.c`, and `bundle.combined.c`
  - for `run-os-sandboxed`, also emits `policy.used.json`

## Report contract

`x07 bundle` prints a machine JSON report to stdout:

- `schema_version: "x07.bundle.report@0.2.0"`
- `report` contains the underlying runner report used to compile the native artifact

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/x07lang) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->