# 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.
- [Agents / LLMs](https://dotfiles.timmo.dev/agents-llms): Machine-readable documentation and hosted MCP tools for AI-assisted sessions.
- [Bar Integrations](https://dotfiles.timmo.dev/bar-integrations): The --bar-json status-bar contract shared by dot commands and external tools.
- [Cleanup](https://dotfiles.timmo.dev/cleanup): Remove stowed links and manually reverse first-use setup changes.

## Configuration

- [Configuration](https://dotfiles.timmo.dev/configuration): Environment options and private git configuration.
- [Environment Variables](https://dotfiles.timmo.dev/configuration/environment): All DOT_*, DOTFILES_*, and OMARCHY_* options that influence dot.
- [Private Git Config](https://dotfiles.timmo.dev/configuration/private-git): The dot-git.yml schema for repository shortcuts, updates, activity, and notifications.
- [Private Dashboard Config](https://dotfiles.timmo.dev/configuration/private-dashboard): The dot-dashboard.yml schema for optional dashboard source cards.
- [Yazi](https://dotfiles.timmo.dev/configuration/yazi): Restore the shared Yazi plugin set across devices.
- [Plannotator](https://dotfiles.timmo.dev/configuration/plannotator): Restore shared Plannotator review settings across devices.
- [Lazygit](https://dotfiles.timmo.dev/configuration/lazygit): Run shared repository maintenance commands from Lazygit.
- [Cursor](https://dotfiles.timmo.dev/configuration/cursor): Cursor launchers and shell command defaults.
- [Packages](https://dotfiles.timmo.dev/configuration/packages): Install packages from the signed public repository, AUR, and private repository.

## Dot

- [The dot Command](https://dotfiles.timmo.dev/dot): The TUI dashboard and CLI that drives the dotfiles system.
- [Command Reference](https://dotfiles.timmo.dev/dot/commands): Every dot command, alias, flag and example, generated from the CLI registry.
- [Stow Workflow](https://dotfiles.timmo.dev/dot/stow): How dotfiles packages are applied into your home directory with GNU Stow.
- [Shell Setup](https://dotfiles.timmo.dev/dot/shell): Shell completions, editing keys, aliases, and small shell helpers.
- [System Utilities](https://dotfiles.timmo.dev/dot/utilities): Health checks, system updates, benchmarks, and optional timers.
- [Notes & Handoffs](https://dotfiles.timmo.dev/dot/notes): Repository notes and the handoff workflow.
- [Usage Analytics](https://dotfiles.timmo.dev/dot/usage): Local-first usage tracking for dot with optional shell-history observations.

## Getting Started

- [Getting Started](https://dotfiles.timmo.dev/getting-started): Bootstrap a fresh Omarchy machine and run the ongoing dotfiles workflow.
- [Install](https://dotfiles.timmo.dev/getting-started/install): Prerequisites, bootstrap build, and the ongoing dotfiles workflow.
- [New Machine Checklist](https://dotfiles.timmo.dev/getting-started/new-machine): Step-by-step setup for a new Omarchy machine.

## Git

- [Git & GitHub](https://dotfiles.timmo.dev/git): Diff, log, status, and a notification inbox across managed repos.
- [Diff & Repo Watcher](https://dotfiles.timmo.dev/git/diff): The dot git-diff TUI and CLI for tracking dirty worktrees and ahead/behind state across managed repos.
- [Context Integration](https://dotfiles.timmo.dev/git/context): How dotfiles OpenCode plugins consume the standalone context tool.
- [Commit Gateway](https://dotfiles.timmo.dev/git/commit): Guarded commits through dot git-commit instead of raw git commit.
- [Notifications](https://dotfiles.timmo.dev/git/notifications): The GitHub notification inbox with read, done, ignore, and bot-read actions.

## Knowledge Base

- [Knowledge Base](https://dotfiles.timmo.dev/knowledge-base): Practical setup notes for system customisations and one-off fixes.
- [FIDO2 Security Key Auth](https://dotfiles.timmo.dev/knowledge-base/fido2-security-key-auth): Set up Omarchy FIDO2 authentication for sudo, polkit, and Hyprlock with touch-first daily prompts.
- [Workspace Setup](https://dotfiles.timmo.dev/knowledge-base/workspace-setup): Rebuild the desktop host's work and non-work workspace layout.
- [Workspace Relayout](https://dotfiles.timmo.dev/knowledge-base/workspace-relayout): Apply and capture ratio-based Hyprland layouts for the active workspace.
- [Workspace Session Recovery](https://dotfiles.timmo.dev/knowledge-base/workspace-session-recovery): Capture and restore Hyprland window sessions after restarts, crashes, or layout experiments.
- [Work Browser Launchers](https://dotfiles.timmo.dev/knowledge-base/work-browser-launchers): Launch work Chrome, Slack, and Discord into predictable Hyprland workspaces.
- [URL Routing and Webapps](https://dotfiles.timmo.dev/knowledge-base/url-routing-webapps): Route matching URLs to Omarchy webapps while keeping the normal browser fallback.
- [Doorbell Popup](https://dotfiles.timmo.dev/knowledge-base/doorbell-popup): Open a Home Assistant camera popup from a doorbell or motion entity.
- [Twitch Desktop Tools](https://dotfiles.timmo.dev/knowledge-base/twitch-desktop-tools): Use the Omarchy Twitch panel and notification recovery commands.
- [Resume Recovery](https://dotfiles.timmo.dev/knowledge-base/resume-recovery): Refresh the Omarchy shell, Git panel, and Twitch notifications after suspend.
- [Git Shell Panel](https://dotfiles.timmo.dev/knowledge-base/git-shell-panel): Use and recover the unified repository and GitHub notification panel.
- [System Health Triage](https://dotfiles.timmo.dev/knowledge-base/system-health-triage): Collect a short health report for freezes, slowdowns, thermal issues, and noisy logs.
- [Desktop Command Wrappers](https://dotfiles.timmo.dev/knowledge-base/desktop-command-wrappers): Small helper scripts for terminal launches, notifications, loading overlays, and workspace placement.
- [GitHub Dotenv Secrets](https://dotfiles.timmo.dev/knowledge-base/github-dotenv-secrets): Import simple .env keys into GitHub Actions repository secrets with gh.

## Omarchy

- [Omarchy & Hyprland](https://dotfiles.timmo.dev/omarchy): Stowed Omarchy Quattro customisations and host overrides.
- [Host Overrides](https://dotfiles.timmo.dev/omarchy/host-overrides): Stowed Omarchy configuration and host overrides.
- [Controls](https://dotfiles.timmo.dev/omarchy/controls): The dot omarchy desktop controls menu and local keybindings.
- [Shell (Quickshell)](https://dotfiles.timmo.dev/omarchy/shell): The Omarchy 4 Quickshell shell, its generated shell.json, and the custom bar plugins.

## Opencode

- [OpenCode & Agents](https://dotfiles.timmo.dev/opencode): Shared OpenCode agents, commands, skills, and plugins.
- [MCP Servers](https://dotfiles.timmo.dev/opencode/mcp): The Model Context Protocol servers wired into the OpenCode config, and a sanitised opencode.json example.
- [Pi](https://dotfiles.timmo.dev/opencode/pi): Lightweight Pi setup alongside the main OpenCode configuration.

## Reference

- [Agents](https://dotfiles.timmo.dev/reference/agents): OpenCode agents defined in this repo.
- [Commands](https://dotfiles.timmo.dev/reference/commands): OpenCode slash commands defined in this repo.
- [Skills](https://dotfiles.timmo.dev/reference/skills): OpenCode skills defined in this repo, including imported ones.
- [Plugins](https://dotfiles.timmo.dev/reference/plugins): OpenCode lifecycle plugins defined in this repo.