-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Efrain Restrepo edited this page Jun 20, 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, top bar, TUI tools, 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| Tool | Command | Purpose |
|---|---|---|
| Claude CLI | claude |
AI pair programmer |
| Ollama | ollama |
Local LLMs (llama3.2, mistral…) |
| GitHub Copilot | gh copilot |
Copilot CLI |
| Alias | Tool | Purpose |
|---|---|---|
lg |
lazygit | Git TUI |
lzd |
lazydocker | Docker TUI |
y |
yazi | File manager |
z |
zoxide | Smart directory navigation |
top |
bottom | Process monitor |
logs |
lnav | Log viewer |
k |
k9s | Kubernetes TUI |
| 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