Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/rgomezcasas/dotfiles/agents-mdgit clone --depth 1 https://github.com/rgomezcasas/dotfilesWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00341 | $0.00341 |
| Opus 5 | $0.00170 | $0.00170 |
| Sonnet 5 | $0.00068 | $0.00068 |
| Haiku 4.5 | $0.00034 | $0.00034 |
Grade A, and why
dotfiles AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Documentation
Refer to the docs/ folder for detailed guides:
docs/karabiner/— Karabiner keyboard shortcutsdocs/nix/— Adding packages (nix, brew, casks, node, Mac App Store)docs/raycast/— Creating Raycast scriptsdocs/scripts/— Creating new scripts (docblock format, structure)docs/shell/— Shell command portability and aliasesdocs/vscode-and-cursor/— Custom shortcuts and settings
Nix symlinks — when to rebuild
Almost every file under config/ (shell, editors, macos, git, agents) is symlinked into place by home-manager with mkOutOfStoreSymlink (see config/nix/system/symlinks.nix). Editing those files takes effect immediately — never suggest running rebuild after editing them.
rebuild is only needed when config/nix/ itself changes:
packages/*.nix— packages added or removedsystem/symlinks.nix— symlink entries added, removed, or repointedsystem/macos-defaults.nix,flake.nix
Special cases:
karabiner.edn→ rungoku(never editkarabiner.json)- Shell config (aliases, functions, zshrc) → only affects new shell sessions
Git
- If you think it makes sense to split something into separate commits, go ahead and do it.
- Do not autocommit
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 31 lines · 341 tokens per session scan A 31697555d51d
dotfiles AGENTS.md is an instructions file published in the GitHub repository rgomezcasas/dotfiles (362 stars, last pushed 14d ago), licensed MIT. It adds 341 tokens to every session, about $0.0017 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
dotfiles CLAUDE.md
Instructions for joshukraine/dotfiles, covering claude.md, about this repository, repository structure, common commands and setup and installation.
dotfiles copilot-instructions.md
Instructions for shunk031/dotfiles, a project described as: 💻 My dotfiles powered by chezmoi; built around Rust-based tools (sheldon/starship/mise, etc.) featuring a unified coding-agent setup across Codex, Claude Code, and Gemini.
dotfiles CLAUDE.md
Instructions for fredrikaverpil/dotfiles, covering claude.md, core commands, verifying a darwin rebuild actually landed, repository architecture and nix architecture patterns.
dotfiles AGENTS.md
AGENTS.md instructions for denysdovhan/dotfiles, covering agents repository guidelines, project structure & module organization, build, test, and development commands, workflow and coding style & naming conventions.
dotfiles AGENTS.md
Cross-platform dotfiles managed by Chezmoi with Homebrew/apt and per-language version managers. One-command bootstrap for macOS and Linux with Neovim, Tmux, Zsh, and AI agent skills.
dotfiles AGENTS.md
AGENTS.md instructions for edbizarro/dotfiles, covering agents, what this is, critical: non-obvious patterns, zsh has a special stow structure and multi-distro conditional logic.