Skip to content

AGENTS.md

Latest commit

 

History

History
58 lines (45 loc) · 2.56 KB

AGENTS.md

File metadata and controls

58 lines (45 loc) · 2.56 KB
Raw

This repo contains a Nix flake for various workstations.

Nix helpers

Shell aliases defined in home/dev/default.nix for managing the flake:

Alias Command Purpose
nx.fmt nix fmt Format all nix files
nx.verify nix flake check Verify the flake
nx.sys.switch nh darwin/os switch Rebuild and switch system config
nx.home.switch nh home switch Rebuild and switch home-manager config
nx.clean nh clean all --keep 10 Remove old generations (keeps 10)

Common resources

The following common files and folders exist in this repo.

  • Shared nix-darwin baseline hosts/darwin/common.nix
  • Common home-manager entrypoint home/home.nix
  • CLI developer tools home/dev
  • Darwin desktop environment home/darwin
  • lazyvim dotfiles home/nvim

Conventions and principles

  • The dotfiles repo lives at ~/.dotfiles.
  • The flake uses flake-parts; host configs under hosts/ are imported as flake modules.
  • Keep home/dev/default.nix focused on simple shared developer tools. If a tool touches multiple configuration branches, needs non-standard setup such as out-of-store symlinks, or requires enough config/comments to document its behavior, split it into a focused module under home/dev/ and import it from home/dev/default.nix.
  • Shared modules may use isDarwin and isLinux checks when behavior needs to vary by platform. Some modules are intentionally shared across Linux and Darwin, so prefer explicit platform guards over host-specific assumptions when adding cross-platform developer tooling.
  • Do not treat repeated homeConfigurations attributes in flake.nix as bugs. They may be intentional for separating workstation, platform, or configuration branches; verify the actual evaluation behavior before proposing changes.

Systems

catharsis

  • The host catharsis is a Linux workstation, check the hostname to determine if running on catharsis
  • Imported from hosts/nixos/catharsis
  • home-manager setup including:
    • the Hyprland desktop environment via home/hyprland
  • nix-ld to enable certain developer tooling which require linking outside the nix store

Darwin

  • VMs and Workstations will be configured from the same derivations, use uname to determine if on Darwin.
  • Shared nix-darwin baseline in hosts/darwin/common.nix, imported by personal and work
  • personal imported from hosts/darwin/personal
  • work imported from hosts/darwin/work
  • home/darwin/default.nix pulls in darwin specific desktop environment stuff