Justin's Dotfiles

Modular dotfiles for Omarchy Linux + Hyprland

Quick Start • Features • What's Inside • Docs

---

Quick Start

git clone git@github.com:justcarlson/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./install.sh

The installer guides you through setup with a polished TUI powered by Gum.

Flag	Effect
--check	Preview changes (dry run)
--skip-packages	Skip optional packages
--skip-secrets	Skip API key setup
--skip-fixes	Skip system fixes
--debug	Enable verbose debug output

---

Features

• Gum-powered TUI — Beautiful prompts with graceful fallbacks
• GNU Stow — Symlink management, edit configs in place
• Package Registry — Single source of truth for optional apps
• Secrets Management — ~/.secrets for API keys (never committed)
• AI-Native Workflow — Built-in support for OpenCode and Claude Code
• Issue Tracking — Local-first task management with beads
• Idempotent — Safe to run multiple times
• Auto-rollback — Restores backups if something fails

---

What's Inside

~/.dotfiles/
├── install.sh            # Interactive installer
├── lib/                  # Modular libraries
├── tests/                # Automated test suite
├── docs/                 # Documentation
├── .beads/               # Local issue tracking
└── omarchy-config/       # Stow package → ~/
    ├── .config/
    │   ├── hypr/         # Hyprland + Hy3 tiling
    │   ├── waybar/       # Status bar
    │   ├── ghostty/      # Terminal
    │   ├── walker/       # App launcher
    │   ├── uwsm/         # Session manager
    │   ├── opencode/     # AI agent config
    │   └── starship.toml # Shell prompt
    ├── .local/bin/       # Custom scripts
    └── .bashrc           # Shell config

---

Documentation

Doc	Description
Docs Index	Full documentation
Keybindings	Keyboard shortcuts
Packages	Available packages
Contributing	Git workflow
Agent Guide	Instructions for AI agents

---

_{Built for Omarchy Linux}