agys AGENTS.md

agys AGENTS.md is an instructions file for Codex, OpenCode from quaywin/agys. It costs 476 tokens per session, scanned B, original, MIT.

Project-specific instructions for developing the agys Go application, including safe binary handling, approved build and test commands, and architecture guidance.

In plain words
What is it for?
Use them when building, testing, installing, or changing the agys codebase.
Why use it?
They help an agent follow the project's rules and avoid damaging a live executable during development.

Instructions file for CodexOpenCode

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/quaywin/agys/agents-md
Clone the repo
git clone --depth 1 https://github.com/quaywin/agys

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.

agentmods badge for agys AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/quaywin/agys/agents-md.svg)](https://agentmods.dev/instructions/quaywin/agys/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/quaywin/agys/agents-md"><img src="https://agentmods.dev/badge/instructions/quaywin/agys/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 476 This file is loaded in full into every session.
When invoked 476 The same file — it is already loaded in full.
Security scan B 1 finding. 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.1 $0.00476 $0.00476
Opus 5 $0.00238 $0.00238
Sonnet 5 $0.00095 $0.00095
Haiku 4.5 $0.00048 $0.00048

Measured 2d ago against content hash 3ebf895b4a5d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade B, and why

agys AGENTS.md scanned grade B with 1 finding 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.

Strips warnings and disclaimersmediumAnti-refusal

Omitting safety caveats hides risk from the user and is a common jailbreak preamble.

- Keep `go vet ./...` clean without warnings.
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 41 lines

What it actually says

AGENTS.md — Development Guidelines for agys

⚠️ Critical Binary Deployment Rule

[!CAUTION] NEVER copy, build, overwrite, or delete the binary at /Users/quaywin/.local/bin/agys directly during agent tasks. (e.g. cp ... /Users/quaywin/.local/bin/agys, go build -o /Users/quaywin/.local/bin/agys, rm /Users/quaywin/.local/bin/agys).

Reason: Overwriting a live executable binary on macOS while active terminal panes, background watchers, or Herdr hooks are running will corrupt running process mappings and trigger an instant kernel SIGKILL ([1] <PID> killed agys).

✅ Allowed Build & Test Procedures

  1. Local Build & Test:
    go build ./...
    go test -v ./...
    
  2. Local Binary in Repository:
    go build -o ./bin/agys .
    
  3. Go Install (Standard):
    go install .
    
    (Installs safely to $GOPATH/bin/agys without touching the system path).

🛠️ Project Architecture & Best Practices

  • Language: 100% Pure Go (Zero Python / pip / asdf / shims dependency).
  • Herdr Integration:
    • cmd/herdr_hook.go: Cobra subcommand agys herdr-hook [session|quota].
    • pkg/profile/herdr.go: Lifecycle hook handler, socket RPC, compact sidebar badge (FormatModelAbbreviation), and Window Title (5H & Weekly quota).
    • pkg/profile/quota.go: GetProfileFullQuotaDetailsForModel with token-based dynamic matching and 3-tier fallback.
  • Model Resolution Order: Explicit -m/--model arg -> Live prompt transcript (USER_SETTINGS_CHANGE) -> .active_model cache -> settings.json -> default Gemini.
  • Quality Assurance:
    • Always run go test ./... and ensure zero test failures before completing tasks.
    • Keep go vet ./... clean without warnings.
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 · 41 lines · 476 tokens per session scan B 3ebf895b4a5d

Subscribe to this mod's changes

agys AGENTS.md is an instructions file published in the GitHub repository quaywin/agys (10 stars, last pushed yesterday), licensed MIT. It adds 476 tokens to every session, about $0.0024 per session on Opus 5. A static security scan graded it B with 1 finding (strips warnings and disclaimers). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other instructions, from other repositories

dingtalk-workspace-cli AGENTS.md

AGENTS.md instructions for DingTalk-Real-AI/dingtalk-workspace-cli, covering repository agent guide, build and test, command framework declaration, flag / help / schema homology and agent schema contract.

DingTalk-Real-AI/dingtalk-workspace-cli · 7,929 tokens

unraid-management-agent copilot-instructions.md

Copilot instructions for ruaan-deysel/unraid-management-agent, covering copilot instructions, copilot workflow, path-specific instructions, reusable prompts and quick commands.

ruaan-deysel/unraid-management-agent · 546 tokens

coral CLAUDE.md

Instructions for cdknorow/coral, covering claude.md - coral go, mission, testing, go unit tests and legacy parity tools (historical reference).

cdknorow/coral · 1,898 tokens

free-ai-gateway AGENTS.md

Instructions for zaber-dev/free-ai-gateway, covering 🤖 free-ai gateway - agentic development guidelines, 🏛️ monorepo architecture & package boundaries, 🛑 strict architectural rules for agents, 💻 essential developer commands and build all packages across monorepo.

zaber-dev/free-ai-gateway · 955 tokens

oastools GEMINI.md

Instructions for erraggy/oastools, covering gemini.md, project overview, building and running, key commands and development conventions.

erraggy/oastools · 1,091 tokens

ksail go-code.instructions.md

Use when writing or editing Go source files in the KSail codebase. Covers error handling, path safety, dependency guard, and package organization conventions.

devantler-tech/ksail · 461 tokens