Overview

An agent-driven Omarchy setup for development, desktop, and automation.

My Omarchy dotfiles (Arch-based). GNU Stow links each package into place, and a compiled dot CLI sets up, updates and checks each machine. It covers public config, desktop customisations, git tooling and a shared OpenCode setup. 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

Hyprland and the Omarchy Shell make the desktop

Agents share skills and guidance

Core

Page	Why
Getting started	Bootstrap a fresh Omarchy machine
Configuration	Private overlay, packages, and tracked app config
`dot` CLI	Setup, sync, stow, doctor, and git helpers (command reference)
Stow packages	One-line blurbs for everything else that is stowed

Desktop

Page	Why
Hyprland	Window manager config and per-host overrides
Ghostty	Terminal config with host overrides
Herdr	Shared agent terminal multiplexer
UWSM	User environment for the graphical session
Omarchy Shell	Quickshell bar, panels, and `timmo.*` plugins

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
Cursor	IDE-embedded agent and launchers

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://dotfiles.timmo.dev/llms.txt	Compact page index
https://dotfiles.timmo.dev/llms-full.txt	Full docs bundle
https://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.