# Dotfiles

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

## Docs

- [Overview](https://dotfiles.timmo.dev/): An agent-driven Omarchy setup for development, desktop, and automation.
- [Getting Started](https://dotfiles.timmo.dev/getting-started): Bootstrap a fresh Omarchy machine and keep it in sync.
- [Configuration](https://dotfiles.timmo.dev/configuration): Private overlay, packages, and tracked app config.
- [Stow Packages](https://dotfiles.timmo.dev/stow): Short blurbs for the other stowed packages in this repo.
- [Pi](https://dotfiles.timmo.dev/agents/pi): Lightweight companion agent harness.
- [Cursor](https://dotfiles.timmo.dev/agents/cursor): IDE-embedded agent, launchers, and mirrored AGENTS rules.

## dot

- [The dot Command](https://dotfiles.timmo.dev/dot/overview): The CLI for setup, sync, and git helpers across managed repos.
- [Command Reference](https://dotfiles.timmo.dev/dot/commands): Every dot command, alias, flag and example, generated from the CLI command tree.

## Desktop

- [Hyprland](https://dotfiles.timmo.dev/desktop/hyprland): Stowed Hyprland config and per-host overrides.
- [Ghostty](https://dotfiles.timmo.dev/desktop/ghostty): Stowed Ghostty config with per-host overrides.
- [Herdr](https://dotfiles.timmo.dev/desktop/herdr): Dotfiles-managed Herdr session config and plugins.
- [UWSM](https://dotfiles.timmo.dev/desktop/uwsm): User environment overrides for the graphical session.
- [Omarchy Shell](https://dotfiles.timmo.dev/desktop/omarchy-shell): Omarchy Quickshell bar, panels, and timmo.* plugins.

## Agents

- [Agents](https://dotfiles.timmo.dev/agents/overview): How OpenCode, skills, and companion harnesses fit together.
- [Skills](https://dotfiles.timmo.dev/agents/skills): Shared agent skills catalogue and repo-local skills.

## OpenCode

- [OpenCode](https://dotfiles.timmo.dev/agents/opencode/overview): Primary coding-agent harness and published config.
- [Agents](https://dotfiles.timmo.dev/agents/opencode/agents): OpenCode agents defined in this repo.
- [Commands](https://dotfiles.timmo.dev/agents/opencode/commands): OpenCode slash commands defined in this repo.
- [Plugins](https://dotfiles.timmo.dev/agents/opencode/plugins): OpenCode lifecycle plugins defined in this repo.