> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reconifyhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Reconify's API reference is read-only for customer data. Do not invent endpoints or authentication behavior beyond the OpenAPI contract.
> The public OpenAPI document contains only the documented external /v2 contract.

# Installation

> Install Reconify from Go, releases, or source.

<Prompt description="Let your AI agent install the right build.">
  Install the Reconify CLI on this machine.

  1. Detect the operating system and CPU architecture.
     Supported release targets are:
     * macOS arm64
     * macOS amd64
     * Linux amd64
     * Windows amd64

  2. Before installing anything:
     * Check whether `reconify` is already installed.
     * If it is, run `reconify version` and report the existing version.
     * Determine the appropriate installation directory already present on PATH.
     * Do not modify unrelated system configuration.

  3. Fetch the latest Reconify release from:
     [https://github.com/ReconifyHQ/reconify/releases/latest](https://github.com/ReconifyHQ/reconify/releases/latest)

  4. Select the release binary that exactly matches this machine's OS and
     architecture.

     Do not guess the asset name or install a binary for another architecture.

  5. Install the binary into an appropriate directory on PATH.

     On Unix-like systems:

     * make the binary executable;
     * prefer a user-writable location already on PATH;
     * only use elevated privileges if necessary, and explain why before doing so.

     On Windows:

     * install the executable into an appropriate directory available on PATH.

  6. If there is no compatible release binary, fall back to:

     go install github.com/reconifyhq/reconify/cmd/reconify\@latest

     Before using the fallback, verify that Go is installed. If Go is unavailable,
     stop and explain what is required rather than silently installing additional
     tooling.

  7. Verify the installation by locating the installed executable and running:

     reconify version
     reconify capabilities

  8. If either verification command fails, diagnose the installation or PATH
     problem before declaring the installation successful.

  9. At the end, report:
     * detected OS and architecture;
     * installation method used (release binary or Go);
     * installed executable path;
     * installed Reconify version;
     * matching passes reported by `reconify capabilities`;
     * whether installation verification succeeded.

  Do not configure credentials, create Reconify resources, or send financial
  data. This task only installs and verifies the CLI.
</Prompt>

Reconify publishes release binaries for macOS (Apple Silicon and Intel), Linux (amd64), and Windows (amd64). Pick a release, or build from source with Go.

## Install from a release

Find every release on the [Reconify releases page](https://github.com/ReconifyHQ/reconify/releases).

### macOS (Apple Silicon)

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -L -o reconify https://github.com/ReconifyHQ/reconify/releases/latest/download/reconify-darwin-arm64
chmod +x reconify && sudo mv reconify /usr/local/bin/
reconify --version
```

### macOS (Intel)

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -L -o reconify https://github.com/ReconifyHQ/reconify/releases/latest/download/reconify-darwin-amd64
chmod +x reconify && sudo mv reconify /usr/local/bin/
reconify --version
```

### Linux (amd64)

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -L -o reconify https://github.com/ReconifyHQ/reconify/releases/latest/download/reconify-linux-amd64
chmod +x reconify && sudo mv reconify /usr/local/bin/
reconify --version
```

### Windows (amd64)

```powershell theme={"theme":{"light":"github-light","dark":"github-dark"}}
Invoke-WebRequest -Uri "https://github.com/ReconifyHQ/reconify/releases/latest/download/reconify-windows-amd64.exe" -OutFile "reconify.exe"
```

Move `reconify.exe` into a folder on your `PATH` (for example, a `C:\reconify` folder you've added to your user `PATH` variable), then confirm it from a new terminal:

```powershell theme={"theme":{"light":"github-light","dark":"github-dark"}}
reconify --version
```

## Go install

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
go install github.com/reconifyhq/reconify/cmd/reconify@latest
```

Make sure your Go binary directory is on `PATH`.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
reconify --version
```

## Build from source

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
git clone https://github.com/ReconifyHQ/reconify.git
cd reconify
make build
./reconify --version
```

The build uses linker flags for version and build time.

<GitHub.Repo repo="ReconifyHQ/reconify" variant="flat" />

## Install the agent skills

If you're driving Reconify from an agent, and most of these docs assume you are, install the skills too:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npx @reconifyhq/skills
```

Reconify is agent-friendly by default: every command emits versioned JSON, and `reconify capabilities` lets an agent discover what a build supports without you explaining it.

The skills go a step further. They're the guided workflows on top of that (`reconify-engine-reconcile`, `reconify-engine-config`, `reconify-engine-debug`, and the rest), so an agent follows a known-good sequence instead of reconstructing one from the CLI reference each time.

Install them before you hand Reconify a real task.

See [Run it with an agent](/cli/agents#install-ready-made-skills) for the full list.

## Where Reconify writes files

Reconify reads local files. Your config controls paths through `file_pattern`, `--left-file`, and `--right-file`.

When using the disk index backend, Reconify writes temporary SQLite-backed index files to `index.spill_dir` or the system temp directory.