Borrowing it
Nothing to install: this file belongs to muthuishere/toolnexus. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/muthuishere/toolnexus/main/CLAUDE.mdgit clone --depth 1 https://github.com/muthuishere/toolnexusWrote 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.
[](https://agentmods.dev/instructions/muthuishere/toolnexus/claude-md)<a href="https://agentmods.dev/instructions/muthuishere/toolnexus/claude-md"><img src="https://agentmods.dev/badge/instructions/muthuishere/toolnexus/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.
<a href="https://agentmods.dev/instructions/muthuishere/toolnexus/claude-md"><img src="https://agentmods.dev/badge/instructions/muthuishere/toolnexus/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.04217 | $0.04217 |
| Opus 5.5 | $0.01687 | $0.01687 |
| Sonnet 5.5 | $0.00843 | $0.00843 |
| Haiku 4.5 | $0.00422 | $0.00422 |
Grade A, and why
toolnexus 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 3d 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.
How it starts
The opening of the file, as written. The whole thing — 236 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
What we're trying to build
toolnexus — a small, vendor-neutral library that gives any LLM the dynamic
capabilities opencode has, ported byte-identically
across eight languages (js/, python/, golang/, java/, csharp/, elixir/, clojure/, rust/):
- Dynamic MCP servers — read an
mcp.json, connect to every server (local stdio + remote streamable-HTTP), expose each server tool as a uniformTool. - Dynamic agent skills — glob a
skills/folder (**/SKILL.md) and expose oneskilltool that loads a skill's instructions + resources on demand (progressive disclosure).
The insight: MCP tools, agent skills, your own functions (defineTool), remote HTTP endpoints, the
built-in shell/file tools, and remote A2A agents are the same thing to an LLM — a named,
described, schema'd callable. toolnexus unifies all these tool sources behind one Tool
interface, emits the schema in OpenAI / Anthropic / Gemini formats, and ships a unified
client with a built-in tool-calling loop (system prompt, skills injection, parallel + chained
tool calls, hooks, streaming, retries, conversation memory, observability metrics).
It is also an inbound endpoint: toolkit.serve(addr, …) exposes the toolkit to the outside
world — today as a remote A2A agent (Agent Card + JSON-RPC over the client loop; SPEC.md §7B).
The whole point of the ports is parity: the same examples/ fixtures must produce the
same behavior in every language. That is the product. Protecting it is the prime directive
below.
Repo layout
| Path | What |
|---|---|
SPEC.md |
The shared contract. The one-page conformance spec (§0) every port must satisfy, plus reference detail (§1–§9). Source of truth for behavior. |
js/ |
TypeScript port — toolnexus (npm). MCP SDK: @modelcontextprotocol/sdk (same as opencode). |
python/ |
Python port — toolnexus (PyPI), Python ≥ 3.11. MCP SDK: mcp. |
golang/ |
Go port — github.com/muthuishere/toolnexus/golang, Go 1.23. MCP SDK: mark3labs/mcp-go. Also ships the toolnexus CLI under cmd/. |
java/ |
Java port — io.github.muthuishere:toolnexus, Java 21. MCP SDK: official io.modelcontextprotocol.sdk:mcp. |
csharp/ |
C# port — Toolnexus (NuGet), .NET. MCP SDK: ModelContextProtocol. |
elixir/ |
Elixir port — toolnexus (Hex), Elixir ≥ 1.16/OTP 26. MCP client: in-house (Toolnexus.Mcp.* — no mature Elixir SDK exists); coverage gate ≥ 95%. |
clojure/ |
Clojure port — net.clojars.muthuishere/toolnexus (Clojars). One .cljc source tree for the JVM and cljgo; koine is its only dependency. |
rust/ |
Rust port — toolnexus (crates.io), edition 2024, tokio. MCP SDK: official rmcp. Held to tier full (conformance/options_manifest.json); remaining gaps (no Gemini client style, Windows unrun) are in CHANGELOG.md and openspec/changes/add-rust-port. |
examples/ |
Shared cross-language fixtures — mcp.json + skills/hello-world/. Every port runs against these; outputs must match. |
openspec/ |
Spec-driven change workflow (OpenSpec). changes/ = active proposals (proposal.md + spec deltas + tasks.md), specs/ = canonical capability specs, changes/archive/ = shipped changes. Run the openspec CLI from the repo root. |
.github/workflows/ci.yml |
Runs all eight suites (JS/Python/Go/Java/C#/Elixir/Clojure/Rust), hermetically (no network, no live LLM). |
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.
- 3d ago Changed · +5 lines · +283 tokens per session 2386765e202e
- 2mo ago First seen · 231 lines · 3,934 tokens per session scan A bebf55108abf
toolnexus CLAUDE.md is an instructions file published in the GitHub repository muthuishere/toolnexus (5 stars, last pushed yesterday), licensed MIT. It adds 4,217 tokens to every session, about $0.0169 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.
toolnexus CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| toolnexus CLAUDE.mdmuthuishere/toolnexus | Instructions file | 5 | yesterday | MIT | A | 4,217 | 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 |