Getting started

Installation

Gearbox Relay runs on Windows, macOS, Linux, iOS, and Android.

Desktop

Download the latest release from GitHub Releases and run the installer for your platform. Launch Gearbox Relay from your applications menu.

Mobile

Install from the App Store (iOS) or Google Play (Android). The Flutter-based mobile client supports capture, enrichment, search, and Stream management.

Build from source

pnpm install
cargo build
pnpm tauri dev

The desktop client is built with Tauri 2.0 (Rust + React). See the contributing guide for full build instructions.

Your first capture

1. Copy any text — a quote from an article, a code snippet, a paragraph from a PDF. Gearbox Relay watches your clipboard.
2. Gearbox Relay captures it automatically. The clipboard watcher detects the copy and sends the text to the AI enrichment pipeline.
3. On-device AI adds tags and a summary. All processing happens locally. No cloud inference.
4. Search for it later. Use the search bar to find anything by keyword or meaning.

Download the AI model

Gearbox Relay needs a local AI model (~500 MB) for enrichment. On desktop, run the download script:

# Windows
scripts/download-qwen-gguf.ps1

# Linux/macOS
scripts/download-qwen-gguf.sh

On mobile, the app prompts you to download the model during onboarding. You can skip and use a lightweight fallback if needed.