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

# Installation

> Install the Craft Agents desktop app on macOS, Windows, or Linux

Craft Agents is a native desktop application. It runs locally on your machine, stores credentials encrypted on disk, and connects to external services only when you configure sources.

## System Requirements

| Platform    | Architectures         | Notes                                                                                            |
| ----------- | --------------------- | ------------------------------------------------------------------------------------------------ |
| **macOS**   | Apple Silicon (arm64) | macOS 11+. Intel Macs are not supported from v0.10.1 onward (v0.10.0 was the final Intel build). |
| **Windows** | x64                   | Windows 10+                                                                                      |
| **Linux**   | x64                   | AppImage format, requires FUSE                                                                   |

<Note>
  **macOS Intel (x64) builds are discontinued as of v0.10.1.** New releases ship for Apple Silicon (M-series) only. Intel Macs can still install the final supported build, v0.10.0, but will not receive future updates. Windows and Linux are unaffected.
</Note>

## Manual Install (Recommended)

<Tabs>
  <Tab title="macOS">
    **Apple Silicon (M1/M2/M3/M4):**

    ```
    https://agents.craft.do/electron/latest/Craft-Agents-arm64.dmg
    ```

    1. Download the `.dmg`
    2. Open the DMG and drag **Craft Agent** to Applications
    3. Launch from Applications or Spotlight (`CMD+Space`, type "Craft Agent")

    <Note>
      **Intel Macs are not supported.** Starting with v0.10.1, Craft Agents ships an Apple Silicon (arm64) build only. The last release with an Intel `.dmg` was v0.10.0.
    </Note>
  </Tab>

  <Tab title="Windows">
    **Download:**

    ```
    https://agents.craft.do/electron/latest/Craft-Agents-x64.exe
    ```

    1. Download and run the installer
    2. Follow the installation prompts (installs to `%LOCALAPPDATA%\Programs\Craft Agent`)
    3. Launch from Start menu or desktop shortcut
  </Tab>

  <Tab title="Linux">
    **Download:**

    ```
    https://agents.craft.do/electron/latest/Craft-Agents-x64.AppImage
    ```

    1. Download the AppImage
    2. Make it executable: `chmod +x Craft-Agents-x64.AppImage`
    3. Run: `./Craft-Agents-x64.AppImage`

    <Note>
      **FUSE required.** Install with:

      * Debian/Ubuntu: `sudo apt install fuse libfuse2`
      * Fedora: `sudo dnf install fuse fuse-libs`
    </Note>
  </Tab>
</Tabs>

## Script Install

For automated installation with checksum verification:

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://agents.craft.do/install-app.sh | bash
    ```

    This downloads, verifies, and installs Craft Agents automatically.
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    irm https://agents.craft.do/install-app.ps1 | iex
    ```

    Run in PowerShell. Downloads, verifies checksum, and runs the installer.
  </Tab>
</Tabs>

## Build from Source

Craft Agents is open source. To build from source:

### Prerequisites

* [Bun](https://bun.sh) — runtime and package manager
* [Node.js](https://nodejs.org) 18+ — required for electron-builder
* Git

### Clone and Build

```bash theme={null}
# Clone the repository
git clone https://github.com/lukilabs/craft-agents-oss.git
cd craft-agents-oss

# Install dependencies
bun install

# Development mode (hot reload)
bun run electron:dev

# Production build (build and run)
bun run electron:start
```

### Build Installers

<Tabs>
  <Tab title="macOS">
    ```bash theme={null}
    # Apple Silicon
    bash apps/electron/scripts/build-dmg.sh arm64
    ```

    Output: `apps/electron/release/Craft-Agents-arm64.dmg`

    <Note>
      Code signing and notarization require Apple Developer credentials. Set `APPLE_SIGNING_IDENTITY`, `APPLE_ID`, `APPLE_TEAM_ID`, and `APPLE_APP_SPECIFIC_PASSWORD` environment variables. Without these, the build will be unsigned.
    </Note>
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    powershell -ExecutionPolicy Bypass -File apps/electron/scripts/build-win.ps1
    ```

    Output: `apps/electron/release/Craft-Agents-x64.exe`
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    bash apps/electron/scripts/build-linux.sh x64
    ```

    Output: `apps/electron/release/Craft-Agents-x64.AppImage`
  </Tab>
</Tabs>

## Launch

After installation:

* **macOS** — Applications folder or Spotlight (`CMD+Space`, type "Craft Agent")
* **Windows** — Start menu, desktop shortcut, or `craft-agents` in terminal
* **Linux** — Run `craft-agents` from terminal (if installed via script) or run the AppImage directly

First launch opens the setup wizard.

## Next Steps

<Card title="Add Sources" icon="plug" href="/sources/overview" horizontal>
  Connect GitHub, Linear, APIs, and local files to extend what the agent can access.
</Card>

<Card title="Optimize command output with RTK" icon="gauge" href="/go-further/performance" horizontal>
  Install RTK and enable Settings → AI → Performance → Token Optimization for command-heavy coding sessions.
</Card>