kache 0.4.1

Zero-copy, content-addressed Rust build cache. No copies, no wasted disk — just hardlinks locally and S3 for sharing.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

---
title: Installation
description: How to install kache using mise, cargo-binstall, or from source.
---

# Installation

kache requires Rust 1.95 or later (it uses `let ... && let` chains and other recent stabilizations). The binary is self-contained — no runtime dependencies.

## Methods

<Tabs items={["mise (recommended)", "cargo-binstall", "from source"]}>
  <Tab value="mise (recommended)">
    [mise](https://mise.jdx.dev) downloads the pre-built binary from GitHub releases and pins the version per project or globally.

    ```sh
    # install globally
    mise use -g github:kunobi-ninja/kache@latest

    # or pin a specific version
    mise use -g github:kunobi-ninja/kache@0.3.1
    ```

    To pin kache in your project so every contributor gets the same version, add it to your `mise.toml`:

    ```toml
    [tools]
    "github:kunobi-ninja/kache" = "latest"
    ```

    Running `mise install` in the project root will install the pinned version.
  </Tab>
  <Tab value="cargo-binstall">
    [cargo-binstall](https://github.com/cargo-bins/cargo-binstall) downloads the pre-built binary from GitHub releases without compiling.

    ```sh
    cargo binstall --git https://github.com/kunobi-ninja/kache kache
    ```

    If a pre-built binary isn't available for your target, use the source install method below.
  </Tab>
  <Tab value="from source">
    ```sh
    cargo install --git https://github.com/kunobi-ninja/kache kache
    ```

    This compiles kache with your local toolchain. It takes a couple of minutes and supports macOS and Linux. Windows is not supported and fails compilation explicitly.
  </Tab>
</Tabs>

## Supported platforms

Pre-built binaries are available for:

| Target | Notes |
|---|---|
| `x86_64-unknown-linux-musl` | Statically linked, works on any Linux |
| `aarch64-unknown-linux-musl` | ARM Linux (AWS Graviton, etc.) |
| `x86_64-apple-darwin` | Intel macOS |
| `aarch64-apple-darwin` | Apple Silicon |

## Verify the installation

```sh
kache --version
```

You should see a version string like `kache 0.3.1`. If the command isn't found, make sure the binary is on your `PATH` (mise handles this automatically).

## Next: enable kache for cargo

Installing the binary doesn't yet wire it into cargo. Run `kache init` to configure `~/.cargo/config.toml`, install the daemon as a login service, and start it — see [Quick start](/docs/getting-started/quick-start) for the full walkthrough.