DOWNLOAD

Download Alfred Desktop.

Alfred Desktop is the optional desktop app for a local Alfred runtime. It connects to `alfred serve`; it does not run agents by itself. Install Alfred core from source or Homebrew when you want the scheduled coding agents.

PICK YOUR BUILD

Desktop app builds, plus the core runtime.

Alfred Desktop gives you a local control surface for plans, agents, setup checks, and logs. The core runtime runs coding agents through the CLI and scheduler.

MACOS macOS 11+ · Apple silicon

Alfred Desktop for macOS

Open the Apple silicon disk image, drag Alfred to Applications, and launch it beside your local alfred serve. Install Alfred core first if you want real agents, schedules, and local state. The app bundle inside the DMG is signed, notarized, and stapled.

Prefer Homebrew? brew install --cask alfred-os installs the same signed app and pulls in the CLI. 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 connect to the local Alfred core runtime over localhost.

Run chmod +x Alfred.AppImage once before launching the AppImage. 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-os.git ~/code/alfred-os
$ cd ~/code/alfred-os
$ 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-os https://github.com/luminik-io/alfred-os
$ brew install alfred-os
$ alfred-install

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

WHAT YOU GET

Core runtime first. Desktop when you want the app.

Alfred core picks up the Slack drafts, plans, and GitHub issues you mark for it, writes code in isolated repo copies, opens pull requests, routes review, and posts a short summary to Slack. Alfred Desktop reads and controls that local runtime.

Alfred core runtime

  • Four agents to start: Drake, Lucius, Ra's al Ghul, and a cleanup agent
  • Scheduled runs for each agent while your chosen host is awake
  • Planning and approval in Slack, plus optional inspection in Alfred Desktop
  • Open source, MIT licensed, yours to read and fork

Alfred Desktop

  • Shows plans, agents, logs, setup checks, memory review, and safe actions
  • Starts or reconnects to alfred serve on localhost
  • Opens Slack and GitHub links outside the app
  • Does not replace the CLI, scheduler, GitHub labels, or Slack approval gates

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