https://github.com/legionio/homebrew-tap
Homebrew formulae for LegionIO tools
https://github.com/legionio/homebrew-tap
homebrew homebrew-tap legion legionio ruby
Last synced: about 1 month ago
JSON representation
Homebrew formulae for LegionIO tools
- Host: GitHub
- URL: https://github.com/legionio/homebrew-tap
- Owner: LegionIO
- License: apache-2.0
- Created: 2026-03-13T18:00:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-01T22:49:56.000Z (3 months ago)
- Last Synced: 2026-04-02T08:41:33.624Z (3 months ago)
- Topics: homebrew, homebrew-tap, legion, legionio, ruby
- Language: Ruby
- Size: 312 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# LegionIO Homebrew Tap
Homebrew formulae for [LegionIO](https://github.com/LegionIO/LegionIO), an extensible async job engine and agentic AI framework for Ruby.
## Installation
```bash
brew tap legionio/tap
brew install legion-tty
```
This installs `legionio` (daemon) and `legionio-ruby` (bundled Ruby runtime) automatically.
For local development with all services:
```bash
brew install legion-dev
```
## Casks
| Cask | Description |
|------|-------------|
| `legion-interlink` | Desktop AI assistant (Electron, arm64) |
```bash
brew install --cask legionio/tap/legion-interlink
```
## Available Formulae
| 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) | -- |
### Dependency Chain
```
legionio-ruby (Ruby + native extensions)
└── legionio (daemon + core + agentic gems)
└── legion-tty (interactive shell)
```
### Why 3 formulas?
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.
## CLI Usage
```bash
# 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 commands
```
## Services
```bash
brew 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)
```
## Updating
```bash
brew update
brew upgrade legion-tty # fast: ~4MB download
brew upgrade legionio # medium: ~10MB download
brew services restart legionio # pick up new version
```
## Migrating from the legacy `legion` formula
The monolithic `legion` formula is deprecated (replaced by the 3-formula split in 2026-03-20). To migrate:
```bash
brew uninstall legion
brew install legion-tty
```
The `legion-tty` install automatically pulls in `legionio` and `legionio-ruby`.
## Troubleshooting
```bash
legion doctor # diagnose config, services, permissions
brew services info legionio # check service status
brew doctor # general Homebrew health check
```
Report issues at https://github.com/LegionIO/homebrew-tap/issues
## Related
- Main framework: https://github.com/LegionIO/LegionIO
- GitHub org: https://github.com/LegionIO
- Install via RubyGems instead: `gem install legionio`