turntax

Name: turntax
Author: TorutDev

by TorutDevversion 0.9.0i★ –iRuns on your computer

Registry nameio.github.TorutDev/turntax

Install

Overview

Description from the maker (original English)

Per-turn token cost of AGENTS.md, CLAUDE.md and other agent instruction files, with safe fixes.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
The registry lists no key to fill in.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "turntax": {
      "command": "npx",
      "args": [
        "-y",
        "turntax",
        "mcp"
      ]
    }
  }
}

Run this in your terminal

claude mcp add turntax -- npx -y turntax mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "turntax": {
      "command": "npx",
      "args": [
        "-y",
        "turntax",
        "mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "turntax": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "turntax",
        "mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account TorutDev, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32620 servers in this category
Published to the registry more recently than 97% of the other 32620 servers in this category
Basic checks equal to or better than 100% of the other 32620 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is turntax safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.9.0) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Intervals MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

Intervals MCP

by ljcl

Remote MCP server for intervals.icu run data and analysis

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

turntax

Coding agents re-send their instruction files with every turn. turntax measures that fixed per-turn cost for a repository, for every agent that reads it, and shows where to cut it.

npx turntax

Try it in the browser, with nothing uploaded: https://torutdev.github.io/turntax/ — drop a folder or enter a public GitHub repository. Links like https://torutdev.github.io/turntax/?repo=owner/name open straight to that repository's report.

State of agent instruction files: what turntax finds in 100 popular repositories, a new edition every month with pinned commits and the script to reproduce it (scripts/state-of.mjs).

Set up the GitHub Action and a config in one command:

npx turntax init

Supported agents

Each agent's documented loading rules decide what is sent on every turn, what loads only when the agent works in a folder or touches a matching file, and what is ignored.

Agent	Files it reads from the repository
Aider	files listed under `read:` in `.aider.conf.yml` (`CONVENTIONS.md` only when listed or passed with `--read`)
Amp	`AGENTS.md` (or `AGENT.md` / `CLAUDE.md`), nested `AGENTS.md`, @-mentioned files, `.agents/skills`, `.claude/skills`
Augment Code	`AGENTS.md` and `CLAUDE.md` at every level, `.augment-guidelines`, `.augment/rules/` (by `type`), skills in `.augment`, `.claude`, `.agents`
Claude Code	`CLAUDE.md`, `CLAUDE.local.md`, `.claude/rules`, skills, commands, subagents, `AGENTS.md` when there is no `CLAUDE.md`
Cline	`.clinerules/`, `.cline/rules/`, skills in `.cline`, `.clinerules`, `.claude`
Continue	`.continue/rules/`
Cursor	`.cursor/rules/*.mdc`, `.cursorrules`, `AGENTS.md`, `CLAUDE.md`, skills in `.agents`, `.cursor`, `.claude`, `.codex`
Devin Local / Devin CLI	`AGENTS.md`, `AGENTS.local.md`, `AGENT.md`, `.windsurfrules`, `CLAUDE.md` at every level, `.devin/rules/`, `.windsurf/rules/`, `.cursor/rules/`, skills
Factory Droid	`AGENTS.md` / `CLAUDE.md` (also in `.factory`, `.agents`, `.agent`), `DESIGN.md`, `.factory/skills`, `.agents/skills`, `.factory/droids`
Gemini CLI	`GEMINI.md`, skills in `.agents` and `.gemini`
GitHub Copilot	`.github/copilot-instructions.md`, `.github/instructions/`, `AGENTS.md`, `CLAUDE.md`, `.claude/rules`, skills in `.github`, `.claude`, `.agents` (VS Code Local harness defaults)
Goose	`.goosehints`, `AGENTS.md`, `@`-included files, skills in `.agents`, `.goose`, `.claude`
Google Jules	root `AGENTS.md`
JetBrains Junie	`.junie/AGENTS.md`, or `AGENTS.md` with `.junie/rules/`, or `.junie/guidelines`; skills in `.junie`, `.agents`
Kilo Code	the first of `AGENTS.md`, `AGENT.md`, `CLAUDE.md`, `CONTEXT.md`, `.kilo/rules`, `.kilocode/rules`, mode rules, `.kilocoderules`, skills
Kiro	`.kiro/steering/`, `AGENTS.md` (nested ones too, every turn), `.kiro/skills`
OpenAI Codex	`AGENTS.md`, `AGENTS.override.md`, `.agents/skills`
OpenCode	`AGENTS.md`, or `CLAUDE.md` when there is none; skills in `.opencode`, `.claude`, `.agents`
Roo Code	`.roo/rules/`, `.roo/rules-{mode}/`, `.roorules`, `AGENTS.md`, skills in `.roo`, `.agents`
TRAE	`.trae/rules/` (`alwaysApply`, `globs`, `description`; three folder levels), `.trae/skills`
Warp	`WARP.md`, else `AGENTS.md`; skills in `.agents`, `.warp`, `.claude` and seven other folders
Windsurf Cascade	`.devin/rules/`, `.windsurf/rules/`, `.windsurfrules`, `AGENTS.md`, skills (legacy agent; new conversations use Devin Local)
Zed	the first of `.rules`, `.cursorrules`, `.windsurfrules`, `.clinerules`, `.github/copilot-instructions.md`, `AGENT.md`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`; `.agents/skills`

Where an agent reads the same skill name from two folders, it is counted once, in the order the agent documents (or an assumed order, noted for that agent).

Agents that load exactly the same files share one row in the report (files loaded only as a /command, which cost nothing per turn, do not split a row):

always  o200k/turn  on-demand  model                tokens/turn  counted by                   100 turns  cached   agents

4 272 53 (no selected model) Claude Code 1 63 0 GPT-6.1 Sol 63 estimate (o200k_base proxy) $0.01 $0.0006 OpenAI Codex, Roo Code, Kiro, JetBrains Junie 1 17 0 (no selected model) Gemini CLI 5 311 59 GPT-6.1 Sol 311 estimate (o200k_base proxy) $0.06 $0.0031 Cursor 4 307 55 GPT-6.1 Sol 307 estimate (o200k_base proxy) $0.06 $0.0031 GitHub Copilot 2 75 0 GPT-6.1 Sol 75 estimate (o200k_base proxy) $0.01 $0.0008 Windsurf Cascade 2 21 32 GPT-6.1 Sol 21 estimate (o200k_base proxy) $0.0042 $0.0002 Cline 1 11 0 GPT-6.1 Sol 11 estimate (o200k_base proxy) $0.0022 $0.0001 Zed 3 84 32 GPT-6.1 Sol 84 estimate (o200k_base proxy) $0.02 $0.0008 Goose, OpenCode, Kilo Code 3 84 51 GPT-6.1 Sol 84 estimate (o200k_base proxy) $0.02 $0.0008 Amp 3 108 32 GPT-6.1 Sol 108 estimate (o200k_base proxy) $0.02 $0.0011 Warp 2 282 19 GPT-6.1 Sol 282 estimate (o200k_base proxy) $0.06 $0.0028 Factory Droid 4 303 51 GPT-6.1 Sol 303 estimate (o200k_base proxy) $0.06 $0.0030 Augment Code 1 63 0 (no selected model) Google Jules 7 330 69 GPT-6.1 Sol 330 estimate (o200k_base proxy) $0.07 $0.0033 Devin Local / Devin CLI

Advice (savings are estimates in o200k tokens per turn) HIGH duplicate CLAUDE.md, AGENTS.md [saves ~48 tokens/turn] 3 identical lines are loaded twice every turn by cursor, copilot, factory-droid, augment, devin. Keep them in one file. HIGH contradiction AGENTS.md, CLAUDE.md [saves ~11 tokens/turn] Conflicting package manager: "Always use npm for installs and scripts in this repository." (AGENTS.md:3) vs "Always use pnpm for installs and scripts in this repository." (CLAUDE.md:5). (Removing the outdated line.) MEDIUM scopable-section CLAUDE.md:12 [saves ~128 tokens/turn] Section "API package" is mostly about packages/api/. Move it to packages/api/AGENTS.md (or CLAUDE.md), a path-scoped rule, or an instructions file ...

(Excerpt of the output for test/fixtures/mixed with --models gpt-6.1-sol.)

What it counts, and how

Model family	How tokens are counted	Label
OpenAI GPT-5.x, gpt-oss	Offline with `o200k_base` (the encoding OpenAI's tiktoken maps them to)	exact
OpenAI GPT-6.x	Offline with `o200k_base`; OpenAI has not published a newer encoding	estimate
Claude	Only Anthropic's `count_tokens` API, with your key and `--claude-api`	API count
Gemini	Only Google's `countTokens` API, with your key and `--gemini-api`	API count

Claude's tokenizer is not public, and Anthropic's docs note that newer Claude models produce noticeably more tokens than older ones for the same text. turntax never shows an OpenAI count as a Claude or Gemini number: without a key those rows say "needs API key". The o200k column is a labelled reference count for every file.

Cost per N turns = tokens per turn × N × input price. The "cached" column assumes every turn reads the context from the prompt cache. Prices come from a dated table with a source link per model (turntax --list-models); pass --prices my-prices.json to use your own.

See docs/how-it-counts.md for the loading rules per agent and their sources.

Advice

All checks are deterministic. Each one shows an estimated saving in o200k tokens per turn.

duplicate: identical lines in two files. A per-turn saving only when one tool loads both; otherwise flagged as drift risk.
contradiction: conflicting rules reaching the same agent (package manager, indentation, quotes, semicolons).
scopable-section: a section mostly about one directory that could load only there (nested file, path-scoped rule, applyTo).
oversized-section: a large always-loaded section that could become an on-demand skill.
size-limit: documented limits (CLAUDE.md under 200 lines, Codex's 32 KiB cut-off, Windsurf's 12,000 characters per rule and 6,000 for global rules, Cursor's 500 lines, Factory's 80,000 characters, Augment's 49,512 characters).
misconfigured: files a tool ignores, such as .md files in .cursor/rules or Windsurf rules without a trigger.
stale-reference: referenced files or npm run scripts that no longer exist.
non-english: non-English sections. The token multiplier is measured only against an English version you supply (--english CLAUDE.md=CLAUDE.en.md) or, if you opt in, a Claude translation (--translate).

Fixing

npx turntax --fix            # print a diff of the safe fixes; nothing is changed

npx turntax --fix --write # apply them

--fix handles four kinds of advice:

duplicate: removes lines from a file when every agent that reads the file also reads the same lines every turn from another file. Skill, command and subagent files are left whole. A CLAUDE.md that repeats at least 80% of the lines of the AGENTS.md next to it, at least 3 of them full sentences, and every file it imports, keeps only its own lines and imports the rest with @AGENTS.md, as Claude Code's docs suggest; agents that read both stop paying for the copy, and the summary says how much any agent now reads on top.
scopable-section: moves a section into the folder it is about: the same file name there (packages/api/CLAUDE.md), a nested AGENTS.md, or a Claude Code rule with paths:. The folder the section is about must already exist, and sections with @imports or relative links stay put. A section moves together with its subsections.
oversized-section: moves a large procedure (a section of at least --section-tokens, 600 by default, whose heading names a release, deploy, setup or similar procedure, or that is mostly numbered steps; each subsection must pass too) into a new skill, .claude/skills/ /SKILL.md for Claude Code or .agents/skills/ /SKILL.md for Codex, and leaves the heading with a one-line pointer. Only the skill's name and description load every turn. Many agents now read one or both folders, but not all of them do (Zed reads only .agents/skills, for example), so by default this fix is often refused; --tools limits the check to the agents you use.
misconfigured: renames .md files in .cursor/rules to .mdc.

Before a fix is kept, the files are classified again with the change applied: every agent must still read every line it read before, including files reached through @imports, and as often as before. The exceptions are moved text: a section moved into a folder may load only when the agent works there, and a procedure moved into a skill only when the skill is used. Otherwise the fix is skipped and the reason is printed. A moved section can reach agents that did not read it before (a nested AGENTS.md is read by more agents than a CLAUDE.md); the summary names them. By default that check covers every supported agent, so a section of AGENTS.md usually stays where it is, because some agents read only the root file. --tools codex,claude-code limits the check

Only the beginning is shown; read the rest in the repo

turntax

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Intervals MCP

README from the maker

turntax

Supported agents

What it counts, and how

Advice

Fixing