What is projtool CLAUDE.md?

Instructions for developers working on the source code of projtool, a Python package and Claude Code server for running machine-learning experiments locally and in remote GPU containers.

Use them when modifying projtool’s source, experiment and container management, Git worktrees, file synchronization, manifests, or its separate documentation repository.

They clarify which files control projtool itself and which files are templates delivered to its users, reducing the risk of changing the wrong behavior.

How zhyx12/projtool configures Claude Code

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/CLAUDE.md

Clone the repo

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

Made for: Claude Code.

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

Your own site

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

Per session 3,126 This file is loaded in full into every session.

When invoked 3,126 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 92% copy Near-identical to another mod 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.03126	$0.03126
Opus 5.5	$0.01250	$0.01250
Sonnet 5.5	$0.00625	$0.00625
Haiku 4.5	$0.00313	$0.00313

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

Security

Grade A, and why

projtool CLAUDE.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

This is a copy

92% identical to projtool AGENTS.md — 43 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 237 lines

How it starts

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

CLAUDE.md — for developers working ON projtool

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

This is NOT the CLAUDE.md that gets shipped to users. That one is at src/projtool/assets/project_templates/CLAUDE.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 + Claude Code 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 Claude Code 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 · 237 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 · 237 lines · 3,126 tokens per session scan A 5d6edc70d588

Subscribe to this mod's changes

projtool CLAUDE.md is an instructions file published in the GitHub repository zhyx12/projtool (1 stars, last pushed 2mo ago), licensed MIT. It adds 3,126 tokens to every session, about $0.0125 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 92% identical to projtool AGENTS.md, differing in 43 lines, and is treated as a copy.

projtool CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
projtool CLAUDE.mdzhyx12/projtool	Instructions file	1	2mo ago	MIT	A	3,126	Claude Code
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 Claude Code