Dotfiles

See More

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.

These are my personal dotfiles

They are tightly tuned for my Omarchy setup and my specific machines, and are not meant to be installed as-is by anyone else. They are unlikely to work on plain Arch (or any other distro) without replicating my setup, and they lean on a deeply integrated private overlay (dotfiles-private) that is not public, so the public repo on its own is an incomplete picture. Use them as a reference to borrow from, or pull individual pieces into your own dotfiles, rather than as a turnkey setup.

The shared OpenCode config (agents, commands, skills, and plugins) is the exception: it is published separately as opencode-config and deliberately written to be portable and reusable on its own.

AI-generated

Large parts of this project - including this documentation and much of the codebase - are generated or heavily assisted by LLMs and coding agents. Expect the rough edges that come with that, and verify anything before relying on it.

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, workflow runs, 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

InstallPrerequisites, bootstrap build, and the ongoing workflow.

New Machine ChecklistStep-by-step setup for a new Omarchy machine.

Explore

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

ConfigurationEnvironment options, private git config, and private packages.

Git & GitHubDiff, log, status, workflow runs, and notifications.

Omarchy & HyprlandManaged Omarchy repos and per-host Hyprland overrides.

Knowledge BasePractical runbooks for system customisations and one-off fixes.

OpenCode & AgentsAgents, commands, skills, and plugins, with the generated reference.

Reference

Bar IntegrationsThe shared --bar-json status-bar contract.

CleanupRemove stowed links and reverse setup side effects.

Agents / LLMsllms.txt bundles for loading the docs into AI-assisted sessions.