Files
dotfiles/AGENTS.md
T
Lap Tran 6eee2509a4 Add Grok Build agent config adapted from Claude Code setup
Wire shared AGENTS.md and Claude settings through home-manager, plus a
native Grok config (always-approve, rose-pine) and a `gb` yolo alias.
2026-07-18 23:03:12 -04:00

1.4 KiB

Project notes for agents

Deliberate decisions in this repo - do NOT silently revert them:

  • homebrew.onActivation.cleanup = "zap" in configuration.nix is intentional. It forces the good habit of declaring every Homebrew package in the Nix config instead of installing things ad-hoc, which keeps the machine reproducible. Do not soften it to uninstall or none. Users are warned about its effect; this note is for anyone tempted to change the setting itself.
  • Agent configs under home/ are the source of truth. home.nix installs them with mkOutOfStoreSymlink, so edits to files in home/ apply live after the first rebuild that creates the symlink. Prefer editing those paths, not the live ~/.claude / ~/.grok copies.
  • Grok Build is first-class here: home/.grok/config.toml and home/AGENTS.md (linked as ~/.grok/AGENTS.md). Claude, Codex, and opencode still share the same home/AGENTS.md for multi-agent work.
  • Shell aliases: cc (Claude skip-permissions), co (Codex full-auto), gb (Grok --yolo). They are intentional high-agency shortcuts.

Maintaining this file

Keep this file for knowledge useful to almost every future agent session in this project. Do not repeat what the codebase already shows; point to the authoritative file or command instead. Prefer rewriting or pruning existing entries over appending new ones. When updating this file, preserve this bar for all agents and keep entries concise.