PRJ: Dotfiles Migration (Optimus → Quantum)

Project Summary

Project

Dotfiles Architecture Migration

Priority

P1 - High

Status

In Progress

Owner

Evan

Source

dotfiles-optimus (nested structure)

Target

dots-quantum (flat structure)

Objective

Migrate dotfiles from the complex nested dotfiles-optimus structure to the simpler flat dots-quantum architecture.

Architecture Comparison

Aspect dotfiles-optimus dots-quantum

Structure

Nested (base/, shell/, terminal/, editor/, wm/, apps/)

Flat (each package is top-level directory)

Installer

.optimus/install.sh with flags

Direct stow commands

Theme

Multiple

Catppuccin Mocha (consistent)

WM Focus

Multiple options

Hyprland-centric

Complexity

High (modular, multi-platform)

Low (opinionated, single-platform)

Migration Status

Migrated Packages (11)

Package Source Status

bash

base/bash

✓ Migrated

bin

base/bin

✓ Migrated

fd

base/fd

✓ Migrated

fish

base/fish

✓ Migrated

fzf

base/fzf

✓ Migrated

git

base/git

✓ Migrated

gpg

base/gpg

✓ Migrated

ripgrep

base/ripgrep

✓ Migrated

ssh

base/ssh

✓ Migrated

vim

base/vim

✓ Migrated

zsh

base/zsh

✓ Migrated

Pending Migration (7)

Package Description Decision

awk

CLI mastery awk scripts

TBD

bash-lib

Bash library functions

TBD

grep-patterns

Grep pattern library

TBD

powershell

PowerShell configs

Skip (Linux-focused)

sed-scripts

CLI mastery sed scripts

TBD

share

Shared resources

TBD

systemd

Systemd user units

TBD

New in Quantum (not from optimus)

Package Description

btop

Resource monitor + Catppuccin theme

fastfetch

12 system info presets

ghostty

Modern terminal emulator

hyprland

Window manager configs

kitty

GPU terminal

lazygit

Git TUI

mako

Notification daemon

oh-my-posh

Cross-shell prompt theme

waybar

Status bar

wofi

Application launcher

Migration Decisions

Keep in Optimus (Archive)

  • CLI mastery scripts (awk, sed-scripts, grep-patterns) - educational tools, may not fit quantum’s streamlined approach

  • bash-lib - evaluate if needed in quantum

  • powershell - Linux-focused quantum doesn’t need this

  • systemd - evaluate per-machine needs

Structure Translation

Optimus Path Quantum Path

base/bash/

bash/

base/bin/

bin/

wm/hyprland/

hyprland/

terminal/ghostty/

ghostty/

terminal/kitty/

kitty/

apps/*

(individual packages)

Post-Migration

When Complete

  1. Archive dotfiles-optimus (keep for reference)

  2. Update symlinks in _projects/personal/ (bash, bin, etc. currently point to optimus)

  3. Update domus-captures documentation

  4. Remove optimus from active use

Symlinks to Update

Current symlinks in _projects/personal/:

bash -> dotfiles-optimus/base/bash
bin -> dotfiles-optimus/base/bin
fd -> dotfiles-optimus/base/fd
fish -> dotfiles-optimus/base/fish
fzf -> dotfiles-optimus/base/fzf
git -> dotfiles-optimus/base/git
gpg -> dotfiles-optimus/base/gpg
ripgrep -> dotfiles-optimus/base/ripgrep
ssh -> dotfiles-optimus/base/ssh
vim -> dotfiles-optimus/base/vim
zsh -> dotfiles-optimus/base/zsh

Related Documentation

Notes

  • dots-quantum commits show packages being added from optimus (2026-03-17)

  • quantum is Hyprland + Catppuccin Mocha focused

  • Private packages (ssh, gpg, hosts, secrets) are gitignored in quantum

  • Local override support: ~/.bashrc.local, ~/.config/hypr/local.conf