gb10-clock-cap AGENTS.md

gb10-clock-cap AGENTS.md is an instructions file for Codex, OpenCode from agjs/gb10-clock-cap. It costs 1,319 tokens per session, scanned B, original, MIT.

A runbook for testing how limiting a GPU’s clock speed affects an AI model server across one or more inference machines.

In plain words
What is it for?
Running GPU clock-cap evaluations, checking server readiness, measuring performance, and reading the recommendation in the generated summary.
Why use it?
It defines the required inputs, measurements, checks, and decision rules so results are comparable and not based on guesswork.

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/agjs/gb10-clock-cap/agents-md
Clone the repo
git clone --depth 1 https://github.com/agjs/gb10-clock-cap

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 gb10-clock-cap AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/agjs/gb10-clock-cap/agents-md.svg)](https://agentmods.dev/instructions/agjs/gb10-clock-cap/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/agjs/gb10-clock-cap/agents-md"><img src="https://agentmods.dev/badge/instructions/agjs/gb10-clock-cap/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,319 This file is loaded in full into every session.
When invoked 1,319 The same file — it is already loaded in full.
Security scan B 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.

ModelPer sessionOnce invoked
Fable 5 $0.01319 $0.01319
Opus 5 $0.00660 $0.00660
Sonnet 5 $0.00264 $0.00264
Haiku 4.5 $0.00132 $0.00132

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

Security

Grade B, and why

gb10-clock-cap AGENTS.md scanned grade B 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.

2. `sudo -n nvidia-smi` works on every host. Clock control needs root.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| `--model` | `curl $API/v1/models \| jq -r .data[0].id` | Every request 404s |
AGENTS.md · 105 lines

How it starts

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

Agent contract

You are running a GPU clock-cap evaluation on one or more inference hosts. This file is the spec. Follow it in order. Do not improvise the measurement method; the thresholds and orderings here exist because the obvious alternatives give wrong answers.

One-command path

./run.sh --hosts "hostA hostB" --api-host hostA --model MODEL_NAME --mode full

Emits results/summary.json. Read verdict.recommend and stop. Everything below is for when you need to deviate.

Inputs you must resolve before running

Input How to get it Fails if wrong
--hosts SSH aliases for every node with a GPU under test Sampler collects nothing
--api-host The node serving the OpenAI-compatible API Benchmarks cannot connect
--model curl $API/v1/models | jq -r .data[0].id Every request 404s
--cap Default 2200. Only change with a reason
--prefill-tokens Mean real prompt size on this system. Default 33000 Probe does not represent the workload

Get the mean prompt size from the server, do not guess:

vllm:request_prompt_tokens_sum / vllm:request_prompt_tokens_count

Preflight gates

run.sh --mode preflight checks all of these and refuses to continue on failure:

  1. Every host reachable over SSH without a password prompt.
  2. sudo -n nvidia-smi works on every host. Clock control needs root.
  3. nvidia-smi -lgc 0,<cap> applies and nvidia-smi -rgc reverts. Some GPUs do not support this. Confirm the reported clock actually changes.
  4. API responds and --model appears in /v1/models.
  5. stdbuf present on every host.

Measurement rules

These are not stylistic preferences. Violating any one of them produces a confidently wrong number.

Normalise throttle time to load seconds, never to uptime. Read cumulative throttle counters from nvidia-smi -q -d PERFORMANCE. Divide by time under load, which for a vLLM server is vllm:e2e_request_latency_seconds_sum. On an idle-heavy host the uptime denominator understates throttling by roughly 100x.

Read the full file on GitHub · 105 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. 4d ago First seen · 105 lines · 1,319 tokens per session scan B 62f2b6145195

Subscribe to this mod's changes

gb10-clock-cap AGENTS.md is an instructions file published in the GitHub repository agjs/gb10-clock-cap (48 stars, last pushed 1mo ago), licensed MIT. It adds 1,319 tokens to every session, about $0.0066 per session on Opus 5. A static security scan graded it B with 2 findings (asks for root, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.