summaryrefslogtreecommitdiff
path: root/AGENTS.md
diff options
context:
space:
mode:
authorBen Sima <ben@bensima.com>2025-12-22 13:31:18 -0500
committerBen Sima <ben@bensima.com>2025-12-22 13:31:18 -0500
commit8d9eb8fa8a20efa4c4318fccef97d21fe91fb092 (patch)
treedfe4a94d2c20653a1b97add68d96ebf5a2856317 /AGENTS.md
parentf8d26da7c054c0a4c89ab12993e00f74ea9260a1 (diff)
Switch to kitty terminal with ef-dream theme, emoji support
- Replace urxvt with kitty as default terminal - Add ef-dream inspired color scheme to kitty - Configure emoji font fallback with Noto Color Emoji - Update xmonad.hs to use kitty for terminal and scratchpads - Fix cmdtree to fetch from GitHub instead of broken git://jb55.com - Remove urxvt.nix and alacritty config - Add AGENTS.md for agentic coding tools
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..75607ef
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# AGENTS.md
+
+## Build Commands
+- `home-manager switch` - Apply home-manager configuration
+- `nixos-generate -f <format> -c ./machines/<machine>.nix` - Generate NixOS image
+- `nix-build` / `nix flake check` - Validate Nix expressions
+
+## Architecture
+- **lib/**: Home-manager modules (common.nix is the base, imports via profiles)
+- **machines/**: NixOS system configurations (oxygen=airgapped, helium/boron=laptops)
+- **profiles/**: Compose lib modules for specific use cases (laptop.nix, darwin.nix)
+- **pkgs/**: Custom Nix package derivations, exposed via overlay.nix
+- **whisper-dictate/**: Standalone package for speech-to-text
+
+## Code Style
+- Nix language with home-manager and NixOS modules
+- Use `let ... in { }` pattern for local bindings
+- Use `inherit` for importing attributes; prefer explicit imports
+- Module arguments: `{ pkgs, lib, ... }:`
+- Constants in lib/const.nix; nixpkgs pin in nixpkgs.nix
+- Follow existing patterns when adding new modules or packages