maru

Section

Guides

A guided path from a fresh install to a fully hermetic, content-addressed build.

These four guides are meant to be read in order. They start with a one-line install, walk through declaring your first task, and end with the two ideas that make maru different from a shell script that happens to run in order: content-addressed caching and hermetic execution. By the last page you will have a build that is fast because it skips work, and reproducible because it cannot depend on anything it did not declare.

  1. Installing maru 2 min Install the maru binary, verify it, and scaffold a project in under a minute.
  2. Your first build 2 min Declare a task with explicit inputs and outputs, then watch maru skip it when nothing changed.
  3. Content-addressed caching 2 min How maru builds a cache key from content, dependencies, and toolchain — and how to share it across a team.
  4. Hermetic task graphs 2 min Sandboxed inputs, a scrubbed environment, and no network — the guarantees that make a maru build reproducible.