Homebrew formulae for LegionIO, an extensible async job engine and agentic AI framework for Ruby.
brew tap legionio/tap
brew install legion-ttyThis installs legionio (daemon) and legionio-ruby (bundled Ruby runtime) automatically.
For local development with all services:
brew install legion-dev| Cask | Description |
|---|---|
legion-interlink |
Desktop AI assistant (Electron, arm64) |
brew install --cask legionio/tap/legion-interlink| Formula | Description | Size |
|---|---|---|
legionio-ruby |
Bundled Ruby 3.4.x with YJIT + native extensions (sqlite3, pg, mysql2, oj, puma, snappy) | ~50MB |
legionio |
LegionIO daemon, core libraries, and agentic extensions | ~10MB |
legion-tty |
Interactive terminal shell and AI chat (legion binary) |
~4MB |
legion-dev |
Full development stack (meta-package: all services) | -- |
legionio-ruby (Ruby + native extensions)
└── legionio (daemon + core + agentic gems)
└── legion-tty (interactive shell)
Gem updates happen several times per week. The Ruby runtime changes rarely. By splitting them, brew upgrade legion-tty downloads a ~4MB tarball instead of a ~54MB full Ruby bundle. Upgrades complete in seconds.
# Interactive shell (from legion-tty)
legion # rich terminal UI with onboarding
legion chat # AI REPL
# Operational daemon (from legionio)
legionio start # start the daemon
legionio config scaffold # generate config files
legionio lex list # list extensions
legionio --help # all commandsbrew services start legionio # start daemon in background
brew services start redis # required for tracing
brew services start rabbitmq # job engine messaging (optional)
brew services start postgresql@17 # persistence (optional)
brew services start vault # secrets (optional)
ollama serve # local LLM (optional)brew update
brew upgrade legion-tty # fast: ~4MB download
brew upgrade legionio # medium: ~10MB download
brew services restart legionio # pick up new versionThe monolithic legion formula is deprecated (replaced by the 3-formula split in 2026-03-20). To migrate:
brew uninstall legion
brew install legion-ttyThe legion-tty install automatically pulls in legionio and legionio-ruby.
legion doctor # diagnose config, services, permissions
brew services info legionio # check service status
brew doctor # general Homebrew health checkReport issues at https://github.com/LegionIO/homebrew-tap/issues
- Main framework: https://github.com/LegionIO/LegionIO
- GitHub org: https://github.com/LegionIO
- Install via RubyGems instead:
gem install legionio