Skip to main content
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

PlatformArchitecturesNotes
macOSApple Silicon (arm64)macOS 11+. Intel Macs are not supported from v0.10.1 onward (v0.10.0 was the final Intel build).
Windowsx64Windows 10+
Linuxx64AppImage format, requires FUSE
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.
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”)
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.

​
Script Install

For automated installation with checksum verification: 
curl -fsSL https://agents.craft.do/install-app.sh | bash
This downloads, verifies, and installs Craft Agents automatically.

​
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

# Apple Silicon
bash apps/electron/scripts/build-dmg.sh arm64
Output: apps/electron/release/Craft-Agents-arm64.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.

​
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.