What is ai_agent_dotfiles AGENTS.md?

Repository instructions for managing configuration files for AI coding tools such as Claude Code, OpenCode, Codex CLI, and Gemini CLI. It documents installation with a script or GNU Stow, a tool that creates and manages symbolic links.

Use it when setting up these configurations, refreshing their links after changes, or removing selected tool configurations.

It explains how to install, update, and remove shared agent configurations without treating the repository like a normal software project.

ai_agent_dotfiles AGENTS.md — Instructions file for Codex and OpenCode by mfmezger: Repository instructions for managing configuration files

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/mfmezger/ai_agent_dotfiles/agents-md

Clone the repo

git clone --depth 1 https://github.com/mfmezger/ai_agent_dotfiles

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/mfmezger/ai_agent_dotfiles/agents-md.svg)](https://agentmods.dev/instructions/mfmezger/ai_agent_dotfiles/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/mfmezger/ai_agent_dotfiles/agents-md"><img src="https://agentmods.dev/badge/instructions/mfmezger/ai_agent_dotfiles/agents-md.svg" alt="Measured on agentmods" height="20"></a>

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

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

Security scan C 2 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.01579	$0.01579
Opus 5	$0.00790	$0.00790
Sonnet 5	$0.00316	$0.00316
Haiku 4.5	$0.00158	$0.00158

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

Security

Grade C, and why

ai_agent_dotfiles AGENTS.md scanned grade C with 2 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 4d 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.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- GNU Stow (macOS: `brew install stow`, Linux: `sudo apt install stow`)

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

cat ~/.claude/settings.json | python -m json.tool

AGENTS.md · 193 lines

How it starts

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

AI Agent Dotfiles - Agent Guidelines

This is a dotfiles repository for AI coding tools (Claude Code, OpenCode, Codex CLI, Gemini CLI), not a software project with build/test artifacts.

Installation & Setup

Installation Commands

# Full installation (runs install.sh)
./install.sh

# Manual installation using stow
stow claude      # Install Claude Code configs to ~/.claude/
stow opencode    # Install OpenCode configs to ~/.config/opencode/
stow codex       # Install Codex CLI configs to ~/.codex/
stow gemini      # Install Gemini CLI configs to ~/.gemini/

# Update symlinks after adding new files
stow -R claude opencode codex gemini

# Unlink configs
stow -D claude opencode codex gemini

Prerequisites

GNU Stow (macOS: brew install stow, Linux: sudo apt install stow)
Bash for install.sh script

Code Style Guidelines

Shell Scripts (install.sh)

Shebang: #!/usr/bin/env bash
Use set -e for error handling
Color output using ANSI codes (RED, GREEN, YELLOW, BLUE, NC)
Function naming: lowercase_with_underscores
Indentation: 2 spaces
Quotes around all variable expansions: "$variable"
Use [[ for tests instead of [
Exit on errors: functions return non-zero to indicate failure

Configuration Files (JSON, Markdown)

JSON: 2-space indentation, no trailing commas
Markdown: Use GitHub Flavored Markdown, line length ~80-100 chars
Paths in comments use absolute paths starting with ~ for user home
Code blocks specify language for syntax highlighting

Project-Specific Conventions

Directory Structure

claude/.claude/
├── settings.json       # User preferences
├── CLAUDE.md          # User-level context
├── agents/            # Custom agents (.md files)
├── skills/            # Skills (directories with SKILL.md)
└── rules/             # User-level rules (.md files)

opencode/.config/opencode/
├── AGENTS.md         # User-level context
├── opencode.json      # Main config with permissions
├── agents/            # Custom agents (.md files)
├── skills/            # Skills (directories with SKILL.md)
├── rules/             # Custom rules (.md files)
└── README.md          # Config documentation

codex/.codex/
├── AGENTS.md         # User-level context
├── rules/            # Codex rules / permissions
└── skills/           # Skills (directories with SKILL.md)

gemini/.gemini/
├── GEMINI.md         # User-level context
├── skills/           # Symlinks to shared skills
└── commands/         # Custom command files (.md)

pi/.pi/agent/
├── AGENTS.md         # User-level context
├── settings.json     # pi settings
└── themes/           # Custom pi themes

shared/
├── context/
│   └── default-coding-guidelines.md  # Canonical shared context source
└── skills/
    └── <skill>/...   # Canonical skill source for all tools

scripts/
├── sync-contexts.sh  # Syncs generated global context files across tools
└── sync-skills.sh    # Syncs per-tool skill symlinks and Gemini commands

Read the full file on GitHub · 193 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.

4d ago First seen · 193 lines · 1,579 tokens per session scan C 321e37556ff5

Subscribe to this mod's changes

ai_agent_dotfiles AGENTS.md is an instructions file published in the GitHub repository mfmezger/ai_agent_dotfiles (5 stars, last pushed 1mo ago), licensed MIT. It adds 1,579 tokens to every session, about $0.0079 per session on Opus 5. A static security scan graded it C with 2 findings (asks for root, reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Building agents claude-code codex codingagents opencode pi-coding-agent

ai_agent_dotfiles AGENTS.md