What is projtool AGENTS.md?

Repository-specific instructions for AI coding agents working on projtool, a Python package and MCP server for managing machine-learning experiments across local computers and remote GPU containers.

Use them when developing projtool, especially when working with worktrees, file syncing, GPU instances, experiment manifests, or its separate documentation repository.

They explain the difference between changing projtool itself and changing files that projtool later gives to its users.

How zhyx12/projtool configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to zhyx12/projtool. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/zhyx12/projtool/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/zhyx12/projtool

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/zhyx12/projtool/agents-md/github.svg)](https://agentmods.dev/instructions/zhyx12/projtool/agents-md)

Your own site

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

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/zhyx12/projtool/agents-md"><img src="https://agentmods.dev/badge/instructions/zhyx12/projtool/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 2,865 This file is loaded in full into every session.

When invoked 2,865 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.1	$0.02865	$0.02865
Opus 5.5	$0.01146	$0.01146
Sonnet 5.5	$0.00573	$0.00573
Haiku 4.5	$0.00286	$0.00286

Measured 2mo ago against content hash 3155ce4dbc1f, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

projtool 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 2mo 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

projtool CLAUDE.md — 92% identical, 43 lines differ

AGENTS.md · 222 lines

How it starts

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

AGENTS.md — for developers working ON projtool

This file is for Codex (or any AI agent) when working in this repository — the projtool source tree.

This is NOT the AGENTS.md that gets shipped to users. That one is at src/projtool/assets/project_templates/AGENTS.md.snippet and is data — it gets injected into user projects during mcp__projtool__retrofit_write_template. Modifying that file changes user-facing behavior; modifying this file changes how you work on projtool itself.

What projtool is, in one paragraph

projtool is a Python package + Codex MCP server that helps a single ML researcher run experiments across a local dev machine and remote AutoDL GPU containers. It manages git worktrees, mutagen sync sessions, AutoDL instance lifecycle, manifest.yaml bookkeeping, and a paired "docs repo" where analysis reports live (separate git repository from the code repo). End users invoke projtool setup once from a shell, then operate through mcp__projtool__* tool calls inside Codex from then on. See docs/product-spec.md for the full product story.

CRITICAL: you are working ON projtool, not WITH projtool

This is the most common confusion when developing this project. Three rules:

The mcp__projtool__* tools do not exist in this development environment. They are the target you are building. References to them in design docs, slash commands, hooks, and skills under src/projtool/assets/ are part of the user-facing API surface — they are what we ship, not what we use to build.
The ml-research-workflow skill at src/projtool/assets/project_skills/ml-research-workflow/ does not apply to this project. That skill is for end-user ML research projects that have been retrofitted with projtool. This project is a Python package; you do not have GPUs, training runs, or experiment_ids. Do not load that skill.
The projtool-bootstrap skill at src/projtool/assets/user_skills/projtool-bootstrap/ also does not apply. It activates in user projects when the user says "set up projtool here". It has no role in developing projtool itself.

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

2mo ago First seen · 222 lines · 2,865 tokens per session scan A 3155ce4dbc1f

Subscribe to this mod's changes

projtool AGENTS.md is an instructions file published in the GitHub repository zhyx12/projtool (1 stars, last pushed 2mo ago), licensed MIT. It adds 2,865 tokens to every session, about $0.0115 per session on Opus 5.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.

projtool AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
projtool AGENTS.mdzhyx12/projtool	Instructions file	1	2mo ago	MIT	A	2,865	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

projtool: Instructions file for Codex