Ruos Macair — Development skill for Claude Code

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

1. Insert the USB drive into the MacBook Air
2. Power on (or restart)
3. Hold the Option (⌥) key immediately until the boot picker appears
4. Select EFI Boot (orange/yellow external drive icon)
5. GRUB shows "ruOS" — press Enter or wait 5 seconds
6. Auto-login as ruv, XFCE desktop loads
7. 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