What is dotfiles AGENTS.md?

Repository instructions for cross-platform dotfiles managed with Chezmoi, a tool that deploys configuration files to a computer. The repository also stores shared coding-agent skills and helper agents.

Use them when managing macOS or Linux shell and editor settings, installing packages, or maintaining the shared agent-skill catalogue.

They explain how to apply, preview, edit, and track configuration changes while following the repository's naming and organization rules.

dotfiles AGENTS.md — Instructions file by urmzd

Install

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.

agentmods

npx agentmods add instructions/urmzd/dotfiles/agents-md

Clone the repo

git clone --depth 1 https://github.com/urmzd/dotfiles

Made for: Codex, OpenCode.

Per session 1,133 This file is loaded in full into every session.

When invoked 1,133 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What 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.01133	$0.01133
Opus 5	$0.00566	$0.00566
Sonnet 5	$0.00227	$0.00227
Haiku 4.5	$0.00113	$0.00113

Measured 2d ago against content hash 251ebeac2f6a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

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.

AGENTS.md · 83 lines

How it starts

The opening of the file, as written. The whole thing — 83 lines — stays where its author put it; the contents beside it link to each section on GitHub.

[chezmoi-dotfiles] Dotfiles Management & Agent Skills Registry

## Project Overview

Cross-platform dotfiles managed by [chezmoi](https://www.chezmoi.io/). Targets macOS (primary) with Nix/Homebrew for package management. Also serves as the source-of-truth for a portable agent skills catalog and a small set of subagents (architect, curator, debugger, guardian, ideator, strategist, technical-documentation-architect, writer). The catalog is **cross-project**: once installed via [`agentspec`](https://github.com/urmzd/agentspec), the same skills and subagents are available to any tool (claude-code, codex, gemini, copilot) from any project, not just this repo.

## Build & Apply

```bash
chezmoi apply          # Deploy dotfiles to $HOME
chezmoi diff           # Preview pending changes
chezmoi add <file>     # Track a new file
chezmoi edit <file>    # Edit source, then apply
```

## File Naming Conventions

| Prefix/Suffix | Meaning |
|---|---|
| `dot_` | Maps to `.` (e.g., `dot_zshrc` -> `~/.zshrc`) |
| `private_` | Restrictive file permissions |
| `.tmpl` | Go `text/template` with chezmoi data |
| `run_once_before_` | Run-once setup script (before apply) |
| `run_once_after_` | Run-once setup script (after apply) |
| `run_onchange_` | Re-runs when content hash changes |

This is the canonical reference for chezmoi naming. `CONTRIBUTING.md` and other docs should link here rather than duplicating the table.

## Key Directories

These paths are **chezmoi source paths** inside this repo. After `chezmoi apply` they are deployed to the locations in the "Deployed at" column, which is where they are picked up by tools and other projects.

| Source path | Deployed at | Contents |
|-----------|-------------|----------|
| `dot_agents/skills/` | `~/.agents/skills/` | Portable agent skills (following [Agent Skills Spec](https://agentskills.io/specification)) |
| `dot_agents/agents/` | `~/.agents/agents/` | Subagent definitions (architect, curator, debugger, guardian, ideator, strateg

Read the full file on GitHub · 83 lines

Changes

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 · 83 lines · 1,133 tokens per session scan A 251ebeac2f6a

Subscribe to this mod's changes

dotfiles AGENTS.md is an instructions file published in the GitHub repository urmzd/dotfiles (3 stars, last pushed 20d ago), licensed Apache-2.0. It adds 1,133 tokens to every session, about $0.0057 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-31.

chezmoi dotfiles neovim nvim tmux zsh

dotfiles AGENTS.md