agents.md

AGENTS.md

@@ -0,0 +1,31 @@
+# AGENTS.md
+
+## ⚠️ VERSION CONTROL: JUJUTSU (jj) ONLY
+**NEVER run git commands.** This repo uses Jujutsu (`jj`). Use `jj status`, `jj diff`, `jj commit`, etc.
+
+## Build Commands
+```bash
+nix run .#build               # Build current host config
+nix run .#build -- <hostname> # Build specific host (chidi, jason, michael, mindy, tahani)
+nix run .#apply               # Build and apply locally (darwin-rebuild/nixos-rebuild switch)
+nix flake check               # Validate flake
+
+# Remote NixOS deployment (colmena)
+colmena build                 # Build all NixOS hosts
+colmena apply --on <host>     # Deploy to specific NixOS host (michael, mindy, tahani)
+colmena apply                 # Deploy to all NixOS hosts
+```
+
+## Code Style
+- **Formatter**: Alejandra with tabs (run `alejandra .` to format)
+- **Function args**: Destructure on separate lines `{inputs, pkgs, ...}:`
+- **Imports**: Use relative paths from file location (`../../profiles/foo.nix`)
+- **Attribute sets**: One attribute per line, trailing semicolons
+- **Lists**: `with pkgs; [...]` for packages, one item per line for long lists
+
+## Structure
+- `hosts/<name>/` - Per-machine configs (darwin: chidi, jason | nixos: michael, mindy, tahani)
+- `profiles/` - Reusable program/service configs (imported by hosts)
+- `modules/` - Custom NixOS/darwin modules
+- `lib/` - Shared constants and utilities
+- `secrets/` - SOPS-encrypted secrets (`.sops.yaml` for config)