Ruos Macair
Description
ruOS for MacBook Air 2012 — custom Linux with DJ, Spotify, Tailscale, and ruOS agent stack
Installation
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open the source below and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
README
ruOS MacBook Air 2012
Custom Linux distribution for MacBook Air Mid-2012 (A1466, Ivy Bridge) with DJ, music streaming, and ruOS agent stack.
What's Included
| Category | Software | Notes |
|---|---|---|
| Desktop | XFCE 4.18 | Lightweight, optimized for 4-8GB RAM |
| GPU | Intel HD 4000 | SNA accel, TearFree, DRI3, VA-API HW decode |
| WiFi | Broadcom BCM4360 | broadcom-sta driver, pre-configured |
| Music | Spotify | Native Linux client |
| DJ | Mixxx 2.4 | Pioneer DDJ-200 mapping pre-configured |
| VPN | Tailscale | Mesh networking |
| Dev | Node.js 22, Rust | Claude Code installed on first login |
| ruOS | mcp-brain, ruvultra-mcp, ruvultra-embedder, ruvultra-profile, ruvultra-init | Full agent stack |
| Audio | PipeWire + low-latency config | rtprio 99, memlock unlimited for DJ |
| Power | TLP | MacBook-specific battery optimization |
Installation from Release
Download the two image parts from [Releases](https://github.com/ruvnet/ruos-macair/releases):
# Reassemble the split image
cat ruos-macair-v0.1.0.img.gz.part-aa ruos-macair-v0.1.0.img.gz.part-ab > ruos-macair-v0.1.0.img.gz
# Decompress
gunzip ruos-macair-v0.1.0.img.gz
# Write to USB (replace /dev/sdX with your USB device — use `lsblk` to find it)
sudo dd if=ruos-macair-v0.1.0.img of=/dev/sdX bs=4M status=progress
sync**WARNING:** `dd` will overwrite the target device. Double-check `/dev/sdX` is your USB drive, not your system disk.
Booting on MacBook Air
- Insert the USB drive into the MacBook Air
- Power on (or restart)
- Hold the Option (⌥) key immediately until the boot picker appears
- Select EFI Boot (orange/yellow external drive icon)
- GRUB shows "ruOS" — press Enter or wait 5 seconds
- Auto-login as
ruv, XFCE desktop loads - WiFi connects automatically
First Login Setup
On first terminal open, the setup script runs automatically and installs:
- Rust toolchain (via rustup)
- Claude Code (via npm)
- claude-flow MCP serv
Related Skills
Auto Update
Pull the latest ECC repo changes and reinstall the current managed targets.
Ecc Guide
Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository su
Epic Claim
Claim an epic issue, stamp coordination state, and sync local ownership.
Epic Publish
Publish a validated epic update back to the issue and local cache.
Epic Review
Mark epic review requested, approved, or changes requested.
Epic Unblock
Sweep blocked epic issues and reopen anything whose dependencies are closed.