# heph

> Build once. Trust the cache.

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [Caching](https://hephbuild.github.io/docs/concepts/caching.md): How heph turns input hashes into cache hits, and how to control and clean the cache.
- [Codegen](https://hephbuild.github.io/docs/concepts/codegen.md): How codegen targets write generated outputs back into your source tree, and when to copy vs. rewrite in place.
- [Dependencies](https://hephbuild.github.io/docs/concepts/dependencies.md): How targets reference each other to form the build graph, and how outputs flow along the edges.
- [Reproducibility](https://hephbuild.github.io/docs/concepts/reproducibility.md): What byte-identical outputs guarantee, and how heph gets there.
- [Sandbox](https://hephbuild.github.io/docs/concepts/sandbox.md): The isolated directory a target runs in, why isolation matters, and how to inspect it.
- [Targets & rules](https://hephbuild.github.io/docs/concepts/targets.md): How heph models a build as a graph of content-addressed targets.
- [Getting started](https://hephbuild.github.io/docs/getting-started.md): Install heph and write your first .hephconfig.
- [Using heph in CI](https://hephbuild.github.io/docs/guides/ci.md): Run builds in CI with stable output, codegen checks, and a warm cache.
- [Claude Code plugin](https://hephbuild.github.io/docs/guides/claude-code-plugin.md): Install the heph-expert plugin to make Claude Code an expert on your heph workspace.
- [Editor setup](https://hephbuild.github.io/docs/guides/editor-setup.md): Connect your editor to heph's language server for completion, hover, and go-to-definition.
- [Your first build](https://hephbuild.github.io/docs/guides/first-build.md): Go from an empty repo to a cached build wiring a dependency and a tool.
- [Inspecting builds](https://hephbuild.github.io/docs/guides/inspecting-builds.md): Use heph inspect to answer why a target rebuilt, what it depends on, and what a provider produced.
- [Remote cache](https://hephbuild.github.io/docs/guides/remote-cache.md): Share build artifacts across machines with a remote cache backed by S3, GCS, Azure, or any HTTP object store.
- [Introduction](https://hephbuild.github.io/docs/intro.md): What heph is, and why builds become fast, reproducible and trustworthy.
- [Buildfile](https://hephbuild.github.io/docs/plugins/buildfile.md): Package provider that scans the workspace for Starlark BUILD files and parses target definitions from them.
- [Exec](https://hephbuild.github.io/docs/plugins/exec.md): Execution drivers for running shell commands in sandboxed target builds.
- [Filesystem](https://hephbuild.github.io/docs/plugins/fs.md): Reference files and directories from the workspace filesystem.
- [Go](https://hephbuild.github.io/docs/plugins/go.md): Go language support — analyze packages and generate library, binary, and test targets.
- [Group](https://hephbuild.github.io/docs/plugins/group.md): Bundle multiple targets as transparent, pass-through dependencies.
- [Hostbin](https://hephbuild.github.io/docs/plugins/hostbin.md): Wraps host system binaries as heph targets via generated wrapper scripts.
- [Plugins](https://hephbuild.github.io/docs/plugins/plugins.md): The plugins that supply heph's functionality — the drivers targets execute through and the providers that discover them.
- [Nix](https://hephbuild.github.io/docs/plugins/nix.md): Builds reproducible shell environments with Nix and exposes their programs as tool binaries.
- [Query](https://hephbuild.github.io/docs/plugins/query.md): Dynamic target selection with a composable query language — boolean operators, label/package predicates, and the query() BUILD-file builtin.
- [Textfile](https://hephbuild.github.io/docs/plugins/textfile.md): Generate text files from inline content, optionally marked executable.
- [Addresses](https://hephbuild.github.io/docs/reference/addresses.md): How targets are named — package, name, output-group selector, and the built-in @heph packages.
- [CLI reference](https://hephbuild.github.io/docs/reference/cli.md): The heph commands you'll use daily.
- [Configuration](https://hephbuild.github.io/docs/reference/configuration.md): Every key in .hephconfig — registering plugins and tuning the engine.