Home

HarnessOS Wiki

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.

---

Pages

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	The local AI brain: wtf/ask, harness-mcp, tuned models, Claude CLI, OpenCode, Continue
Troubleshooting	Common boot, login, and build errors with solutions

---

Quick start

# 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

What ships

AI Tools

Tool	Command	Purpose
Shell AI	wtf, ask	Diagnose failures / ask with system context
Claude CLI	claude	AI pair programmer — harness-mcp preconnected
OpenCode	opencode	AI coding agent on local Ollama + harness-mcp
Continue	VS Code	Chat/edit/autocomplete on local Ollama
Ollama	ollama	Local LLMs, auto-tuned to your hardware
GitHub Copilot	gh copilot	Copilot CLI

TUI Tools

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

Desktop keybindings

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