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
macOSIntel, Apple SiliconmacOS 11+
Windowsx64Windows 10+
Linuxx64AppImage format, requires FUSE
Apple Silicon (M1/M2/M3/M4):
https://agents.craft.do/electron/latest/Craft-Agent-arm64.dmg
Intel:
https://agents.craft.do/electron/latest/Craft-Agent-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”)

​
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

# Intel
bash apps/electron/scripts/build-dmg.sh x64
Output: apps/electron/release/Craft-Agent-{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.

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