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	Intel, Apple Silicon	macOS 11+
Windows	x64	Windows 10+
Linux	x64	AppImage format, requires FUSE

Manual Install (Recommended)

macOS

Apple Silicon (M1/M2/M3/M4):

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

Intel:

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

1. Download the .dmg for your architecture
2. Open the DMG and drag Craft Agent to Applications
3. Launch from Applications or Spotlight (CMD+Space, type “Craft Agent”)

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

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

FUSE required. Install with:

• Debian/Ubuntu: sudo apt install fuse libfuse2
• Fedora: sudo dnf install fuse fuse-libs

Script Install

For automated installation with checksum verification:

macOS / Linux

curl -fsSL https://agents.craft.do/install-app.sh | bash

This downloads, verifies, and installs Craft Agents automatically.

Windows

irm https://agents.craft.do/install-app.ps1 | iex

Run in PowerShell. Downloads, verifies checksum, and runs the installer.

Build from Source

Craft Agents is open source. To build from source:

Prerequisites

• Bun — runtime and package manager
• Node.js 18+ — required for electron-builder
• Git

Clone and Build

# 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

macOS

# Apple Silicon
bash apps/electron/scripts/build-dmg.sh arm64

# Intel
bash apps/electron/scripts/build-dmg.sh x64

Output: apps/electron/release/Craft-Agents-{arch}.dmg

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.

Windows

powershell -ExecutionPolicy Bypass -File apps/electron/scripts/build-win.ps1

Output: apps/electron/release/Craft-Agents-x64.exe

Linux

bash apps/electron/scripts/build-linux.sh x64

Output: apps/electron/release/Craft-Agents-x64.AppImage

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

Add Sources

Connect GitHub, Linear, APIs, and local files to extend what the agent can access.