Overview

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

Dotfiles

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

Get started

Bootstrap a fresh Omarchy machine and run the ongoing dotfiles workflow.

View on GitHub

Browse the public source and generated references.

These are my public Omarchy dotfiles (Omarchy is an Arch Linux based distro), managed with GNU Stow and a single compiled dot binary. They cover shell, editor, and desktop config, plus the tooling that keeps multiple machines in sync.

At a glance

Stow-based dotfiles

Public config for shell, editor, and tooling, rooted at ~/.config/dotfiles and laid down with GNU Stow.

The dot binary

A single compiled binary (Bun + Effect v4 + OpenTUI) with a TUI dashboard and a full CLI for setup, updates, and git tooling.

Git & GitHub tooling

Diff, log, status, and a notification inbox across every managed repo, with status-bar modules.

Omarchy & Hyprland

Managed Omarchy repos and per-host Hyprland overrides, with a desktop controls menu.

OpenCode & agents

Shared agents, commands, skills, and plugins, published to opencode-config.

Private overlay

A deeply integrated private overlay (~/.config/dotfiles-private) layers machine-specific config on top of the public repo.

Get started

Install

Prerequisites, bootstrap build, and the ongoing workflow.

New Machine Checklist

Step-by-step setup for a new Omarchy machine.

Explore

The dot Command

The TUI dashboard and CLI, with the stow, notes, and utilities workflows.

Configuration

Environment options, private git config, and private packages.

Git & GitHub

Diff, log, status, and notifications.

Omarchy & Hyprland

Managed Omarchy repos and per-host Hyprland overrides.

Knowledge Base

Practical runbooks for system customisations and one-off fixes.

OpenCode & Agents

Agents, commands, skills, and plugins, with the generated reference.

Reference

Bar Integrations

The shared –bar-json status-bar contract.

Cleanup

Remove stowed links and reverse setup side effects.

Agents / LLMs

Machine-readable docs, hosted MCP, and model-less AI surfaces.