AGENTS.mdA

AGENTS.md from cotal-ai/cotal is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add cotal-ai/cotal/AGENTS.md@git:20261104.5d6a29a

Pins git:20261104.5d6a29a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
cotal-ai/cotal
Path
AGENTS.md
Versions recorded
35
Latest version
git:20261104.5d6a29a, committed Nov 4, 2026
First version recorded
Aug 18, 2026
Size
23,869 bytes
Repository stars
380
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md

Guidance for any coding agent (Claude Code, OpenCode, Codex, Cursor, and others) working in
this repo. This is the **canonical** agent guide; `CLAUDE.md` points here.

Keep your answers short and to the point.

## What this is

**Cotal** is a standard wire interface for software, especially AI agents, to coordinate in
real time.
The wire contract (subjects, message schemas, presence/discovery conventions) *is* the standard;
libraries are thin clients over it. Transport is **NATS + JetStream**; the reference
implementation is **TypeScript**.

**Thin waist, real substance, guarded core:**

- **Thin waist** — the normative wire contract (subjects, schemas, presence/discovery, delivery
semantics, the owner+actor auth grammar) is the standard.
- **Pluggable edges** — identity, transport, storage, secrets, discovery, payments are adapters over
existing building blocks. Compose, don't reinvent (e.g. any OIDC IdP plugs in via a thin
auth-callout adapter).
- **Not hollow** — the substance is the contract *and its guarantees*, the reference implementation,
and the local operator tooling; not a bare shim.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cotal-ai/cotal/AGENTS.md@sha256:57effe0ccf5a9e23

The line at the top of this page pins the label git:20261104.5d6a29a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_i33gadl6g3fujsp7.svg)](https://markdownregistry.com/a/art_i33gadl6g3fujsp7)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 35 versions of this file, between Aug 18, 2026 and Nov 4, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261104.5d6a29a latest2026-11-04 5d6a29a 23,869 BA view · diff
git:20261104.96454ff2026-11-04 96454ff 23,606 BA view · diff
git:20261104.252016b2026-11-04 252016b 23,290 BA view · diff
git:20261103.959d5432026-11-03 959d543 23,873 BA view · diff
git:20261103.f013c4d2026-11-03 f013c4d 23,826 BA view · diff
git:20261101.4eca0132026-11-01 4eca013 23,324 BA view · diff
git:20261101.2ff03d02026-11-01 2ff03d0 23,276 BA view · diff
git:20261101.aabc2332026-11-01 aabc233 23,207 BA view · diff
git:20261101.13499c02026-11-01 13499c0 23,099 BA view · diff
git:20261101.6fcac9f2026-11-01 6fcac9f 23,278 BA view · diff
git:20261028.50ee6242026-10-28 50ee624 22,838 BA view · diff
git:20261024.ab634642026-10-24 ab63464 22,835 BA view · diff
git:20261022.9cc91172026-10-22 9cc9117 22,717 BA view · diff
git:20261020.68393372026-10-20 6839337 22,650 BA view · diff
git:20261020.1a3939c2026-10-20 1a3939c 22,607 BA view · diff
git:20261020.06e95152026-10-20 06e9515 21,032 BA view · diff
git:20261010.5500c712026-10-10 5500c71 20,206 BA view · diff
git:20261008.328d59b2026-10-08 328d59b 20,066 BA view · diff
git:20261008.8370a222026-10-08 8370a22 19,776 BA view · diff
git:20261006.96c28f62026-10-06 96c28f6 19,626 BA view · diff
git:20261004.e584be32026-10-04 e584be3 19,530 BA view · diff
git:20261004.426c3e42026-10-04 426c3e4 19,351 BA view · diff
git:20261004.99eda4b2026-10-04 99eda4b 19,238 BA view · diff
git:20261003.608f5f42026-10-03 608f5f4 19,063 BA view · diff
git:20260927.8595a552026-09-27 8595a55 18,714 BA view · diff
git:20260926.83f97d02026-09-26 83f97d0 18,488 BA view · diff
git:20260926.e39f6de2026-09-26 e39f6de 18,275 BA view · diff
git:20260924.794acb12026-09-24 794acb1 18,136 BA view · diff
git:20260917.ee64b032026-09-17 ee64b03 17,612 BA view · diff
git:20260917.6f248ac2026-09-17 6f248ac 17,427 BA view · diff
git:20260905.a85001e2026-09-05 a85001e 17,254 BA view · diff
git:20260905.e6d3c962026-09-05 e6d3c96 17,155 BA view · diff
git:20260830.e5e68ed2026-08-30 e5e68ed 16,595 BA view · diff
git:20260827.5aa8a562026-08-27 5aa8a56 16,576 BA view · diff
git:20260818.5b0642e2026-08-18 5b0642e 16,377 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (23869 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cotal-ai/cotal · 380 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i33gadl6g3fujsp7
GET https://markdownregistry.com/api/v1/resolve?ref=cotal-ai/cotal/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/57effe0ccf5a9e23c8291a3678eb2dee01329f328d11d52cae868b266dc572d7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from cotal-ai/cotal

cold-review SKILL.md skill
cotal-ai/cotal · .claude/skills/cold-review/SKILL.md · Write the brief for a single independent cold reviewer and grade what it returns, keeping it isolated from the panel…
git:20260828.4605050 · audit A · 380 stars
parallel-feature-managers SKILL.md skill
cotal-ai/cotal · .claude/skills/parallel-feature-managers/SKILL.md · Run several independent Cotal features concurrently by creating one Git worktree and one spawn-capable mesh manager per…
git:20261101.13499c0 · audit A · 380 stars
pixel-face SKILL.md skill
cotal-ai/cotal · .claude/skills/pixel-face/SKILL.md · Create or improve a 32×32 pixel-art persona face for the Frontier Faces demo (examples/04-frontier-faces/personas.mjs)…
git:20260630.58d0aa6 · audit A · 380 stars
CLAUDE.md CLAUDE.md file
cotal-ai/cotal · CLAUDE.md
git:20260619.3e93e9b · audit B · 380 stars
team-topology SKILL.md skill
cotal-ai/cotal · claude-plugin/cotal-skills/skills/team-topology/SKILL.md · Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the…
git:20261004.8a9d279 · audit A · 380 stars
team-topology SKILL.md skill
cotal-ai/cotal · implementations/cli/cotal-skills/skills/team-topology/SKILL.md · Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the…
git:20260813.2ba90d1 · audit A · 380 stars
llms.txt llms.txt file
cotal-ai/cotal · llms.txt
git:20261101.13499c0 · audit A · 380 stars
cotal-mesh SKILL.md skill
cotal-ai/cotal · skills/cotal-mesh/SKILL.md · Put an AI agent on a Cotal mesh and coordinate with other agents across vendors and machines. Use when a user runs two…
git:20261026.e22a38a · audit A · 380 stars
cotal-setup SKILL.md skill
cotal-ai/cotal · website/public/.well-known/agent-skills/cotal-setup/SKILL.md · Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on…
git:20261026.e22a38a · audit A · 380 stars

Every file in cotal-ai/cotal

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.