@xgent-ai/skills 0.1.0 → 0.3.0

package/skills/working-with-mbx/references/cli/completion.md

@@ -0,0 +1,27 @@
+mbx completion
+
+`mbx completion` [​](#mbx-completion)
+
+- **Usage:** `mbx completion <SHELL>`
+
+Generate a self-contained shell completion script.
+
+## Arguments [​](#arguments)
+
+- **`<SHELL>`** — Shell: bash, zsh, fish, or powershell.
+
+## Flags [​](#flags)
+
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/mod.rs)
+
+Last updated:
+
+Pager
+
+[Previous pagesetup](https://mr-boxington.jdx.dev/cli/setup)
+
+[Next pagedoctor](https://mr-boxington.jdx.dev/cli/doctor)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/doctor.md

@@ -0,0 +1,24 @@
+mbx doctor
+
+`mbx doctor` [​](#mbx-doctor)
+
+- **Usage:** `mbx doctor [--json]`
+
+Check the local installation, cache, toolchain, and remote connection.
+
+## Flags [​](#flags)
+
+- **`--json`** — Print a stable machine-readable report.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/doctor.rs)
+
+Last updated:
+
+Pager
+
+[Previous pagecompletion](https://mr-boxington.jdx.dev/cli/completion)
+
+[Next pageexplain](https://mr-boxington.jdx.dev/cli/explain)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/exec.md

@@ -0,0 +1,28 @@
+mbx exec
+
+`mbx exec` [​](#mbx-exec)
+
+- **Usage:** `mbx exec [--project-root <DIR>] <COMMAND>…`
+
+Run a build command outside cargo with its C and C++ compiles cached.
+
+## Arguments [​](#arguments)
+
+- **`<COMMAND>…`** — Build command and its arguments.
+
+## Flags [​](#flags)
+
+- **`--project-root <DIR>`** — Directory that identifies the project across worktrees.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/exec.rs)
+
+Last updated:
+
+Pager
+
+[Previous pageprefetch](https://mr-boxington.jdx.dev/cli/prefetch)
+
+[Next pagecache](https://mr-boxington.jdx.dev/cli/cache/)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/explain.md

@@ -0,0 +1,29 @@
+mbx explain
+
+`mbx explain` [​](#mbx-explain)
+
+- **Usage:** `mbx explain [--last] [CARGO_COMMAND] [CARGO_ARGS]…`
+
+Explain cache bypasses, or replay the last build and diagnose its misses.
+
+## Arguments [​](#arguments)
+
+- **`[CARGO_COMMAND]`** — Cargo subcommand to run under diagnostics.
+- **`[CARGO_ARGS]…`** — Arguments to pass to the Cargo subcommand.
+
+## Flags [​](#flags)
+
+- **`--last`** — Explain the most recent recorded build without running Cargo again.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/explain.rs)
+
+Last updated:
+
+Pager
+
+[Previous pagedoctor](https://mr-boxington.jdx.dev/cli/doctor)
+
+[Next pageclean](https://mr-boxington.jdx.dev/cli/clean)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/gc.md

@@ -0,0 +1,28 @@
+mbx gc
+
+`mbx gc` [​](#mbx-gc)
+
+- **Usage:** `mbx gc [FLAGS]`
+
+Collect learned incremental state and managed targets, then evict cached objects to fit budgets.
+
+A missing cached object is rebuilt when it is needed again.
+
+## Flags [​](#flags)
+
+- **`--max-size <SIZE>`** — Size the store may occupy afterwards, for example 20GiB. Defaults to the configured budget.
+- **`--json`** — Print a stable machine-readable report.
+- **`--dry-run`** — Show what collection would remove without changing any files.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/gc.rs)
+
+Last updated:
+
+Pager
+
+[Previous pageclean](https://mr-boxington.jdx.dev/cli/clean)
+
+[Next pagetui](https://mr-boxington.jdx.dev/cli/tui)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/prefetch.md

@@ -0,0 +1,27 @@
+mbx prefetch
+
+`mbx prefetch` [​](#mbx-prefetch)
+
+- **Usage:** `mbx prefetch <CARGO_ARGS>…`
+
+Download predicted remote artifacts without running Cargo.
+
+## Arguments [​](#arguments)
+
+- **`<CARGO_ARGS>…`** — Cargo subcommand and arguments whose previous manifest should be warmed.
+
+## Flags [​](#flags)
+
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/prefetch.rs)
+
+Last updated:
+
+Pager
+
+[Previous pagestats](https://mr-boxington.jdx.dev/cli/stats)
+
+[Next pageexec](https://mr-boxington.jdx.dev/cli/exec)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/setup.md

@@ -0,0 +1,28 @@
+mbx setup
+
+`mbx setup` [​](#mbx-setup)
+
+- **Usage:** `mbx setup [FLAGS]`
+
+Make plain Cargo commands run through mbx.
+
+## Flags [​](#flags)
+
+- **`--yes`** — Accept the recommended activation scope without prompting.
+- **`--global`** — Activate the Cargo wrapper in mise's global configuration.
+- **`--local`** — Activate the Cargo wrapper in the current project's mise configuration.
+- **`--status`** — Report whether plain Cargo integration is installed and current.
+- **`--uninstall`** — Remove mbx activation from the selected scope.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/setup.rs)
+
+Last updated:
+
+Pager
+
+[Previous pageCLI commands](https://mr-boxington.jdx.dev/cli/)
+
+[Next pagecompletion](https://mr-boxington.jdx.dev/cli/completion)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/stats.md

@@ -0,0 +1,24 @@
+mbx stats
+
+`mbx stats` [​](#mbx-stats)
+
+- **Usage:** `mbx stats [--json]`
+
+Show lifetime savings, pruning totals, and estimated storage shared across workspaces.
+
+## Flags [​](#flags)
+
+- **`--json`** — Print a stable machine-readable report, with byte counts and nanoseconds.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/stats.rs)
+
+Last updated:
+
+Pager
+
+[Previous pagetui](https://mr-boxington.jdx.dev/cli/tui)
+
+[Next pageprefetch](https://mr-boxington.jdx.dev/cli/prefetch)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli/tui.md

@@ -0,0 +1,24 @@
+mbx tui
+
+`mbx tui` [​](#mbx-tui)
+
+- **Usage:** `mbx tui [--once]`
+
+Watch cache activity across every build on this machine.
+
+## Flags [​](#flags)
+
+- **`--once`** — Print one plain-text snapshot instead of taking over the terminal.
+- **`-h --help`** — Print help
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/tui.rs)
+
+Last updated:
+
+Pager
+
+[Previous pagegc](https://mr-boxington.jdx.dev/cli/gc)
+
+[Next pagestats](https://mr-boxington.jdx.dev/cli/stats)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/cli.md

@@ -0,0 +1,58 @@
+mbx
+
+`mbx` [​](#mbx)
+
+**Usage:** `mbx [+TOOLCHAIN] <SUBCOMMAND>`
+
+**Version:** 1.15.0
+
+- **Usage:** `mbx [+TOOLCHAIN] <SUBCOMMAND>`
+
+## Arguments [​](#arguments)
+
+- **`[+TOOLCHAIN]`** — Toolchain to run under, named the way rustup names it: `mbx +1.91 check`.
+
+## Flags [​](#flags)
+
+- **`-h --help`** — Print help
+- **`-V --version`** — Print version
+
+## Subcommands [​](#subcommands)
+
+- [`mbx completion <SHELL>`](https://mr-boxington.jdx.dev/cli/completion)
+- [`mbx doctor [--json]`](https://mr-boxington.jdx.dev/cli/doctor)
+- [`mbx explain [--last] [CARGO_COMMAND] [CARGO_ARGS]…`](https://mr-boxington.jdx.dev/cli/explain)
+- [`mbx setup [FLAGS]`](https://mr-boxington.jdx.dev/cli/setup)
+- [`mbx gc [FLAGS]`](https://mr-boxington.jdx.dev/cli/gc)
+- [`mbx cache <SUBCOMMAND>`](https://mr-boxington.jdx.dev/cli/cache)
+- [`mbx cache trace <SESSION>`](https://mr-boxington.jdx.dev/cli/cache/trace)
+- [`mbx cache dir [--json]`](https://mr-boxington.jdx.dev/cli/cache/dir)
+- [`mbx cache stats [--json]`](https://mr-boxington.jdx.dev/cli/cache/stats)
+- [`mbx cache projects`](https://mr-boxington.jdx.dev/cli/cache/projects)
+- [`mbx cache largest [--limit <LIMIT>]`](https://mr-boxington.jdx.dev/cli/cache/largest)
+- [`mbx cache verify`](https://mr-boxington.jdx.dev/cli/cache/verify)
+- [`mbx cache export [--group <GROUP>] [--format <FORMAT>] <ARCHIVE>`](https://mr-boxington.jdx.dev/cli/cache/export)
+- [`mbx cache import <ARCHIVE>`](https://mr-boxington.jdx.dev/cli/cache/import)
+- [`mbx cache remove [--interactive] [WORKSPACE]`](https://mr-boxington.jdx.dev/cli/cache/remove)
+- [`mbx clean [WORKSPACE]`](https://mr-boxington.jdx.dev/cli/clean)
+- [`mbx adopt [-r --recursive] [--dry-run] [PATH]…`](https://mr-boxington.jdx.dev/cli/adopt)
+- [`mbx tui [--once]`](https://mr-boxington.jdx.dev/cli/tui)
+- [`mbx stats [--json]`](https://mr-boxington.jdx.dev/cli/stats)
+- [`mbx prefetch <CARGO_ARGS>…`](https://mr-boxington.jdx.dev/cli/prefetch)
+- [`mbx exec [--project-root <DIR>] <COMMAND>…`](https://mr-boxington.jdx.dev/cli/exec)
+
+## Configuration [​](#configuration)
+
+- [Settings](https://mr-boxington.jdx.dev/configuration#settings)
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/crates/mbx/src/cli/mod.rs)
+
+Last updated:
+
+Pager
+
+[Previous pageConfiguration](https://mr-boxington.jdx.dev/configuration)
+
+[Next pagesetup](https://mr-boxington.jdx.dev/cli/setup)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)

package/skills/working-with-mbx/references/compared.md

@@ -0,0 +1,67 @@
+How mbx compares
+
+How mbx compares [​](#how-mbx-compares)
+
+Choose a cache around the work you want to reuse: compiler invocations, whole CI directories, or edits within one checkout. mbx focuses on Cargo workflows, with shared compiler results, managed targets, and a scheduler for simultaneous builds.
+
+| Your main need | Start by evaluating |
+| --- | --- |
+| Cargo worktrees, bounded local storage, and concurrent builds | mbx |
+| A broader compiler set or distributed compilation | [sccache](#sccache) |
+| A persistent cache service and hardlinked local outputs | [kache](#kache) |
+| Restore Cargo state between GitHub Actions jobs | [Archive-based caching](#tarball-ci-caches) |
+| Recompile the crate you are editing within one checkout | [Incremental compilation](#cargos-incremental-compilation) |
+
+For measured performance, use [Benchmarks](https://mr-boxington.jdx.dev/benchmarks). Feature comparisons do not predict speed on a particular project.
+
+## sccache [​](#sccache)
+
+[sccache](https://github.com/mozilla/sccache) is an established compiler cache with a broader compiler scope, including CUDA, and support for distributed compilation. It can store cached results locally or in remote storage.
+
+mbx's Cargo integration combines several responsibilities:
+
+- An agent starts and stops with each command, so configuration changes apply to the next build without restarting a persistent service.
+- Portable keys map workspace, target, registry, toolchain, and sysroot roots automatically. Matching work can be restored across checkouts.
+- [Managed targets](https://mr-boxington.jdx.dev/managed-targets) add cleanup policies for checkout outputs as well as a budget for cached objects.
+- [Parallel builds](https://mr-boxington.jdx.dev/scheduling) share compiler permits across independent Cargo processes using the same cache root.
+- [Build reports](https://mr-boxington.jdx.dev/cache-results) separate misses, unavailable lookups, and intentional bypasses for each command.
+
+sccache and mbx both use `RUSTC_WRAPPER`. They cannot cache the same Rust invocation together; mbx defers to an existing wrapper. Follow the [migration guide](https://mr-boxington.jdx.dev/cookbook/migrate#from-sccache) when switching.
+
+## kache [​](#kache)
+
+[kache](https://github.com/kunobi-ninja/kache) directly inspired mbx. Both use content-addressed compiler results to share work across checkouts and support Rust plus C and C++ workflows. The projects do not share code.
+
+kache uses hardlinks for local output sharing and offers a persistent service. mbx starts an agent per command and tries to reflink outputs into place. Reflinks share data blocks until a file is modified; writes to a restored output do not modify the cache object. On filesystems without clone support, mbx copies the bytes, so the disk savings depend on the filesystem.
+
+mbx also manages the lifetime of target directories it creates and coordinates simultaneous builds through a shared compiler pool. These features address worktree cleanup and contention as well as compilation reuse. Explicit `CARGO_TARGET_DIR` values remain under your control.
+
+For remote sharing, mbx supports both [S3-compatible buckets](https://mr-boxington.jdx.dev/remote-cache) and a [protocol server](https://mr-boxington.jdx.dev/cache-server). The server can enforce separate read and write grants by namespace. Bucket deployments need equivalent restrictions in their storage permissions. Client-side write policy is an additional guard, not an authorization boundary.
+
+Evaluate both with the same source, toolchain, targets, and filesystem. The [published benchmark method](https://mr-boxington.jdx.dev/benchmarks#keeping-it-fair) describes how this project keeps comparisons consistent.
+
+## Tarball CI caches [​](#tarball-ci-caches)
+
+[`actions/cache`](https://github.com/actions/cache) saves selected paths as an archive. [`Swatinem/rust-cache`](https://github.com/Swatinem/rust-cache) adds Rust-specific keys and pruning. They preserve Cargo's target state so a job can reuse outputs without asking a compiler cache for every artifact.
+
+The default [`jdx/mr-boxington-action`](https://github.com/jdx/mr-boxington-action) backend also transports a pruned Cargo target and registry archive. The build then runs through mbx, gaining its compiler scheduling and per-action reuse within the job. This is an archive transport, so it still pays archive restore and save costs.
+
+The action's `objects` mode transports mbx's recorded action closure instead. A configured cache server or S3 bucket transfers individual objects, letting builds fetch the work they need across different target layouts. Choose one transport for the same cached data; stacking archive actions adds duplicate work. See [GitHub Action](https://mr-boxington.jdx.dev/github-action) for the tradeoffs and examples.
+
+## Cargo's incremental compilation [​](#cargos-incremental-compilation)
+
+Incremental compilation reuses parts of a crate between edits in one checkout. A shared compiler cache reuses complete matching results across builds.
+
+mbx uses both: it shares eligible compilations and automatically keeps private incremental state for crates whose sources you are changing. That private state is never published to the shared cache. Setting `MBX_INCREMENTAL=1` gives Cargo control of workspace incremental compilation and can reduce cross-checkout reuse. See [Incremental builds](https://mr-boxington.jdx.dev/incremental) before changing the default.
+
+[Edit this page on GitHub](https://github.com/jdx/mr-boxington/edit/main/docs/compared.md)
+
+Last updated:
+
+Pager
+
+[Previous pageCaching limits](https://mr-boxington.jdx.dev/limits)
+
+[Next pageBenchmarks](https://mr-boxington.jdx.dev/benchmarks)
+
+MIT License·Copyright © 2026· [jjdx.dev](https://jdx.dev)