Setup

Basic Installation

You can download the pre-built macOS application or install it via Homebrew:

Assistant Configuration

Cauchy is built to work with the tools you already have installed on your Mac. You can choose which provider to use for answering questions about your documents.

Claude Code & Codex CLIs

If you have the Claude Code or Codex CLI tools installed and authenticated on your machine, Cauchy can use them directly. Cauchy will automatically detect your local installation and use it to power the assistant features.

Note on Sandboxing: Cauchy is distributed as an unsandboxedapplication. Apple's App Sandbox prevents applications from spawning arbitrary terminal commands or interacting with your shell environment. By running unsandboxed, Cauchy can securely spawn your locally installed CLIs and utilize your existing authentications.

Gemini API

You can also provide a Gemini API key. Just open Cauchy's settings and paste your key. This will use the Gemini API directly for processing your document queries.

Apple Intelligence

For macOS 27.0 (Golden Gate) or later, Cauchy supports on-device Apple Intelligence models. This requires a compatible Apple Silicon Mac and will process everything entirely on your device.