Task Tracker

Last Updated: 2026-02-22

Current Status

The dotfiles repository uses a dendritic architecture with flake-parts:

Flake-parts modules: Every .nix file is a flake-parts module
Cross-cutting features: Modules co-locate darwin + HM concerns (fish, zsh, nushell, 1password, docker, zed)
import-tree auto-discovery: New modules in modules/features/ are automatically discovered
Typed host options: dotfiles.hosts.* in modules/options.nix
Shared HM options: dotfiles.{hostname,sshKeys,onePasswordAgentSock} bridge data between modules
No specialArgs: All values flow through the module system
1Password integration: SSH agent + shell plugins + shared keys via options

See ADR-007 for architecture decisions.

Potential enhancements, not currently prioritized:

Add more fish plugins — fzf.fish, z, autopair.fish
Add Neovim/Helix configuration — modules/features/neovim/ or modules/features/helix/
Add tmux configuration — modules/features/tmux.nix
Module testing patterns — _test.nix convention
Documentation generation — Auto-generate docs from module structure