agentmods.dev

mac-set-up AGENTS.md

Repository guidance for a macOS setup tool that installs developer software and configures system preferences through shell scripts.

In plain words
What is it for?
Understanding or modifying the installer, its language-specific setup scripts, and its macOS environment configuration.
Why use it?
It gives a coding agent the project’s purpose, structure, commands, and conventions before it changes files.

Instructions file for CodexOpenCode

11 23d ago A scan 558 tokens original MIT
View the source file ben196888/mac-set-up
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/ben196888/mac-set-up/agents-md
Clone the repo
git clone --depth 1 https://github.com/ben196888/mac-set-up

Made for: Codex, OpenCode.

Per session 558 This file is loaded in full into every session.
When invoked 558 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.

ModelPer sessionOnce invoked
Fable 5 $0.00558 $0.00558
Opus 5 $0.00279 $0.00279
Sonnet 5 $0.00112 $0.00112
Haiku 4.5 $0.00056 $0.00056

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

Security

Grade A, and why

mac-set-up 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 · 44 lines

How it starts

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

AGENTS.md

This file provides guidance to Codex when working with code in this repository.

What This Repo Does

This is a macOS development environment automation tool. Running ./install.sh sets up a complete dev environment in one shot: Homebrew, CLI tools, languages, IDEs, browsers, productivity apps, AI coding tools, and system preferences.

Running

chmod +x install.sh
./install.sh

Individual scripts can also be run directly, for example ./languages/python.sh or ./agentic/agentic_skills.sh --codex.

There are no build, lint, or test commands. This is a shell-based installer with no automated test suite.

Architecture

install.sh is the orchestrator and executes the other scripts in order:

  1. essential.sh - Xcode CLT, Rosetta 2, Homebrew with Apple Silicon vs Intel path detection
  2. cli_tools.sh - OpenSSL, ripgrep, ast-grep, tree, ack
  3. git/install.sh - Git config, ed25519 SSH key generation, GitHub CLI auth
  4. zsh/install.sh - Zsh, Oh My Zsh, Starship prompt
  5. terminal.sh - Ghostty terminal
  6. languages/ - Per-language setup scripts for .NET, Go, Java, JavaScript, LaTeX, Python, Rust
  7. ides.sh - VS Code, Cursor
  8. browsers.sh - Firefox, Chrome, Edge, DuckDuckGo
  9. devtools.sh - OrbStack, kubectl, Postman, Google Cloud SDK, ChatGPT, Claude Code, Playwright CLI
  10. agentic/install.sh - Agentic instructions, skills, and MCP setup
  11. tools.sh - AppCleaner, Spotify, Slack, Messenger, Signal, Discord, Rectangle
  12. macos.sh - System defaults such as Dock, trackpad, keyboard, and Spotlight configuration

Key Conventions

  • Always use the BREW_PREFIX variable from essential.sh instead of hardcoding Homebrew paths.
  • Config files live alongside their installers and are copied into place. Do not switch this repo to symlink-based setup.
  • Manage reusable agent setup through agentic/install.sh; configuration lives in agentic/agentic.conf.
  • Shell profile additions should be conditional so a missing tool does not break the shell.
  • Prefer cp and cp -r for installation steps.

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

  1. 2d ago First seen · 44 lines · 558 tokens per session scan A 35df48dd750f

Subscribe to this mod's changes

mac-set-up AGENTS.md is an instructions file published in the GitHub repository ben196888/mac-set-up (11 stars, last pushed 23d ago), licensed MIT. It adds 558 tokens to every session, about $0.0028 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.

macosmacos-setupsetupsetup-macossetup-script
Related

Other instructions, from other repositories

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.

denysdovhan/dotfiles · 659 tokens

Applite CLAUDE.md

Instructions for milanvarady/Applite, covering claude.md, project overview, build & run, architecture and data flow.

milanvarady/Applite · 2,572 tokens

wispterm AGENTS.md

Instructions for xuzhougeng/wispterm, covering agents.md, architecture, ui presentation styles, cohesion and coupling and integration layer vs feature domains.

xuzhougeng/wispterm · 5,997 tokens

HomeClaw AGENTS.md

Instructions for omarshahine/HomeClaw, covering homeclaw, architecture, project structure, build system and xcode version.

omarshahine/HomeClaw · 10,044 tokens

liney AGENTS.md

Instructions for everettjf/liney, covering liney repository collaboration guide, 交流语言 / communication language, project overview, repository layout and build and test.

everettjf/liney · 1,589 tokens

best-claude-hud AGENTS.md

Instructions for GaoSSR/best-claude-hud, covering project agent instructions and release work.

GaoSSR/best-claude-hud · 215 tokens