Alfred
Alfred is an open-source tool that turns Claude Code, Codex, or OpenCode into an autonomous engineering team. It plans, implements, tests, and reviews work from GitHub issues, producing pull requests without requiring you at the keyboard. It is for solo developers and small teams who want to delegate ongoing coding tasks while keeping control over approvals and merges.
✨ Key features
- Spec-driven autonomous workflow from issue to pull request
- Routes roles to Claude Code, Codex, or OpenCode
- Isolated worktrees for code changes and review
- Local memory with SQLite and optional providers
- Approval gates and merge policy control
- Verification evidence included in agent PRs
🎯 Use cases
- Implement planned features from GitHub issues
- Address review comments and follow-up tests
- Perform dependency bumps across repositories
- Run multi-repo rollouts with architectural splitting
- Automate routine coding tasks between check-ins
📦 Installation
🧰 Requirements: macOS or Linux, with Claude Code, Codex, or OpenCode installed and authenticated; GitHub account and authentication required.
Desktop app on macOS
brew tap luminik-io/alfred https://github.com/luminik-io/alfred
brew install --cask alfred-os
Headless CLI
brew tap luminik-io/alfred https://github.com/luminik-io/alfred
brew install alfred-os
alfred-install
gh auth login
claude auth login
alfred-init
For Linux or a source install:
git clone https://github.com/luminik-io/alfred.git ~/code/alfred
cd ~/code/alfred
bash install.sh
gh auth login
claude auth login
./bin/alfred-init.py
🚀 Usage
Run the demo:
curl -fsSL https://raw.githubusercontent.com/luminik-io/alfred/main/get.sh | sh
cd ~/alfred
./bin/alfred demo
⚠️ Good to know
Alfred is not a filesystem or network sandbox; it runs with your local user permissions and requires explicit repository configuration for scheduling and indexing.
❓ FAQ
Which coding engines does Alfred support?
Alfred supports Claude Code, Codex, and OpenCode as validated execution engines, and can route different roles to different engines.
Does Alfred merge its own pull requests?
No, by default Alfred does not merge its own PRs; merge authority is left to a person or an explicit repository policy.
Can I disable telemetry?
Yes, anonymous aggregate telemetry is enabled by default but can be disabled at any time with alfred telemetry off.
What operating systems are supported?
Alfred supports macOS and Linux, with macOS on Apple silicon as the primary packaged target for the desktop app.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.