Alfred
DOWNLOAD

Download Alfred Desktop.

Alfred Desktop is the recommended full local install. It bundles Alfred core resources, installs or repairs the CLI and full built-in agent roster on first launch, starts `alfred serve`, and then guides fleet setup, including roster themes and custom display names.

Download Desktop for macOS Linux packages GitHub
PICK YOUR BUILD

Desktop app builds with core runtime bundled.

Alfred Desktop gives you the guided installer plus local control surface for plans, agents, setup checks, and logs. The same open-source core runtime runs coding agents through the CLI and scheduler underneath.

MACOS macOS 11+ · Apple silicon

Alfred Desktop for macOS

Open the Apple silicon disk image, drag Alfred to Applications, and launch it. Setup's Install or repair action bootstraps Alfred core, deploys the local CLI/agents, starts alfred serve, and continues the guided fleet setup. The app bundle inside the DMG is signed, notarized, and stapled.

Download DMG App zip

Prefer Homebrew? brew install --cask alfred-os installs the same signed app and pulls in the CLI formula. The DMG is the normal direct-download path, and the app zip is available for automation and verification.

LINUX Debian / Ubuntu

Alfred Desktop for Linux

Use the AppImage when you want a portable binary, or the .deb package on apt-based systems. Both include bundled Alfred core resources and can install or repair the local runtime before connecting over localhost.

Download AppImage Download .deb

Run chmod +x Alfred.AppImage once before launching the AppImage. Setup uses the same Debian/Ubuntu install lane as install.sh. Linux packages are unsigned; review the release asset digests on GitHub if your environment requires it.

FROM SOURCE

Install Alfred core from the code.

This is the runtime path: Alfred CLI, local state, scheduler files, labels, and agents. Clone the repo and run the installer, or use the Homebrew tap on macOS.

Install Alfred core from source

Clone the repo, step in, and run the installer. Works on macOS and Debian or Ubuntu Linux. Safe to re-run.

install from source copy
$ git clone https://github.com/luminik-io/alfred.git ~/code/alfred
$ cd ~/code/alfred
$ bash install.sh

Use this path when you want the latest main, core runtime, framework edits, or Linux.

Install Alfred core with Homebrew

For macOS, if you prefer a package-manager install of the latest tagged release.

install with homebrew copy
$ brew tap luminik-io/alfred https://github.com/luminik-io/alfred
$ brew install alfred-os
$ alfred-install

Puts alfred, alfred-init, and the rest of the Alfred commands on your PATH.

WHAT YOU GET

Desktop-first setup, full fleet underneath.

Alfred Desktop is the recommended local installer and control surface. Under it, the open-source runtime schedules the full engineering fleet, works in isolated repo copies, opens pull requests, routes review, and reports the result through the app, Slack, and GitHub.

Full engineering fleet

  • Drake scopes work, Batman coordinates approved multi-repo plans, and Lucius builds as senior-dev
  • Ra's al Ghul checks PRs, Bane adds coverage, and Nightwing handles high-priority review comments
  • Batman and Damian install enabled with the full fleet, then stay idle until their parent-repo or spec scope exists
  • The architect only creates child work after alfred architect setup writes the parent planning repo, approval channel, trusted operator settings, and ARCHITECT_AUTO_EXECUTE=approval-gate
  • Huntress and Gordon load with the fleet and self-idle until staging smoke or ECS health settings exist
  • Robin, automerge, agent-cleanup, memory-harvest, memory-auto-promote, code-map-refresh, agent-morning-brief, fleet-doctor, fleet-recap-morning, fleet-recap-evening, shipped-summary-daily, and shipped-summary-weekly keep the loop inspectable
  • Scheduled runs continue while your chosen host is awake
  • Open source, MIT licensed, yours to read and fork

Alfred Desktop

  • Installs or repairs core, detects existing installs, and reconnects to the local runtime
  • Lets you choose the Batman default roster, another preset, or custom agent names while keeping role slugs stable
  • Shows plans, agents, logs, setup checks, memory review, and safe actions
  • Starts or reconnects to alfred serve on localhost
  • Keeps Slack and GitHub as the shared approval and review surfaces
  • Leaves the CLI, scheduler, labels, and approval gates visible instead of hiding them

New to all this? Read the install guide or pick a starting point.

See all release files