Installation

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.

Manual Install (Recommended)

macOS

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

https://thecraftagents.com/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.

Windows

Download:

https://thecraftagents.com/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://thecraftagents.com/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

Script Install

For automated installation with checksum verification:

macOS / Linux

curl -fsSL https://thecraftagents.com/install-app.sh | bash

This downloads, verifies, and installs Craft Agents automatically.

Windows

irm https://thecraftagents.com/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

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.

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.

Optimize command output with RTK

Install RTK and enable Settings → AI → Performance → Token Optimization for command-heavy coding sessions.