-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Efrain Restrepo edited this page Jun 18, 2026
·
4 revisions
Arch Linux-based distro for AI-powered software development.
Ships with Claude CLI, Ollama, GitHub Copilot, Hyprland, Docker, Firefox, VS Code, and a complete dev stack — ready in minutes.
| Page | Description |
|---|---|
| Overview | What is HarnessOS, what ships, kernel and filesystem decisions |
| Building | Build from source with Docker or native Arch Linux |
| Live Environment | Booting from USB, keybindings, sidebar, online setup |
| Installation | TUI installer walkthrough, disk layout, BTRFS subvolumes, GPU setup |
| AI Tools | Claude CLI, Ollama, GitHub Copilot — usage and configuration |
| Troubleshooting | Common boot, login, and build errors with solutions |
# Build the ISO (any Linux with Docker)
git clone https://github.com/Codigo-Free/HarnessOS.git
cd HarnessOS
./scripts/build-docker.sh
# Flash to USB
sudo dd if=out/harnessOS-*.iso of=/dev/sdX bs=4M status=progress oflag=sync && sync
# Boot from USB — auto-logs in as harness, launches Hyprland
# Then run the installer:
harness-install| Shortcut | Action |
|---|---|
| SUPER + Return | Terminal (Kitty) |
| SUPER + B | Firefox |
| SUPER + E | VS Code |
| SUPER + C | Claude AI |
| SUPER + O | Ollama |
| SUPER + R | App launcher |
| SUPER + 1-4 | Switch workspace |
| SUPER + W | Close window |
Repository: https://github.com/Codigo-Free/HarnessOS