Overview

A headless Ubuntu server build of my dotfiles, with a shared Herdr session.

The headless Ubuntu Server build of my dotfiles. It is a cut-down copy of the Omarchy desktop setup with the terminal and service tooling only, and it hosts a Herdr session that other machines attach to. GNU Stow links each package into place, and a compiled dot CLI sets up, updates and checks the machine. Private machine details live in a separate overlay.

# Pull, refresh config, re-stow and rebuild
dot update

# Run the health checks and save a report
dot doctor

How it fits together

Stow links the packages into place

dot sets up and maintains the machine

Agents share skills and guidance

Core

Page	Why
Getting started	Bootstrap the server
Configuration	Private overlay, packages, and tracked app config
Distros	The desktop build and any others, with their own docs sites
`dot` CLI	Setup, sync, stow, doctor, and git helpers (command reference)
Stow packages	One-line blurbs for everything else that is stowed

Server

Page	Why
Overview	What this build keeps, drops, and still has open
Herdr	Shared agent session that remote clients attach to

Agents

Page	Why
Overview	How OpenCode, skills, and companions fit together
Skills	Shared catalogue and repo-local skills
OpenCode	Primary coding-agent harness
Pi	Lightweight companion agent

Machine-readable docs

Build-time llms.txt bundles and a read-only docs MCP, generated from the same source as the site.

URL	Use
https://ubuntu-server.dotfiles.timmo.dev/llms.txt	Compact page index
https://ubuntu-server.dotfiles.timmo.dev/llms-full.txt	Full docs bundle
https://ubuntu-server.dotfiles.timmo.dev/mcp	Hosted MCP (search, page and navigation)
`/{route}.md`	One page as Markdown

Ask AI on the site is off. For live repo state, use context rather than these static bundles.