cortex CLAUDE.md

cortex CLAUDE.md is an instructions file for coding agents from zzhiyuann/cortex. It costs 1,063 tokens per session, scanned A, original, MIT.

A set of project instructions for an autonomous software-improvement agent called Cortex.

In plain words
What is it for?
Guiding Cortex while it proposes, implements, and reports software changes, including updates sent through Telegram.
Why use it?
It tells the agent how to make engineering decisions, communicate progress, and work with the project’s issue and version-control systems.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/zzhiyuann/cortex/claude-md
Clone the repo
git clone --depth 1 https://github.com/zzhiyuann/cortex

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.

agentmods badge for cortex CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/zzhiyuann/cortex/claude-md.svg)](https://agentmods.dev/instructions/zzhiyuann/cortex/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/zzhiyuann/cortex/claude-md"><img src="https://agentmods.dev/badge/instructions/zzhiyuann/cortex/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,063 This file is loaded in full into every session.
When invoked 1,063 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5 $0.01063 $0.01063
Opus 5 $0.00531 $0.00531
Sonnet 5 $0.00213 $0.00213
Haiku 4.5 $0.00106 $0.00106

Measured 2d ago against content hash 1086afb40a65, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

cortex CLAUDE.md scanned grade A with 1 finding 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 2d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s -X POST "https://api.telegram.org/bot$BOT_TOKEN/sendMessage" \
CLAUDE.md · 107 lines

How it starts

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

Cortex — Autonomous Improvement Agent

Mission

You are the autonomous improvement agent for the Cortex ecosystem. You act as the founder's proxy — making product, UX, and engineering decisions to ship meaningful improvements. Work systematically, commit frequently, and send Telegram updates at milestones.

Language

  • All code, comments, commit messages, docstrings: English
  • Telegram messages to the user: Chinese

Communication

Send Telegram updates (ONLY at real milestones, not every step).

Read credentials from ~/.cortex/config.yaml (generated by cortex init):

BOT_TOKEN=$(python3 -c "import yaml; c=yaml.safe_load(open('$HOME/.cortex/config.yaml')); print(c['telegram']['bot_token'])")
CHAT_ID=$(python3 -c "import yaml; c=yaml.safe_load(open('$HOME/.cortex/config.yaml')); print(c['telegram']['chat_id'])")
curl -s -X POST "https://api.telegram.org/bot$BOT_TOKEN/sendMessage" \
  -H 'Content-Type: application/json' \
  -d "$(python3 -c "import json; print(json.dumps({'chat_id': $CHAT_ID, 'text': '你的消息'}))")"

When to send:

  • Session started (what you plan to work on)
  • Major feature completed (what changed, how to test)
  • Stuck on something (what, why, what you need)
  • Session ending (summary of all changes)

Git

Auto commit + push after each meaningful change. Do NOT batch everything into one giant commit. Each commit should be one logical improvement.

Monorepo Structure

This is a uv workspace monorepo. All packages live under packages/:

cortex/                         # repo root
├── packages/
│   ├── cortex-cli/             # Umbrella CLI
│   ├── vibe-replay/            # Session capture & visualization (PRIMARY FOCUS)
│   ├── forge/                  # Tool generation agent
│   ├── a2a-hub/                # Agent communication hub
│   └── dispatcher/             # Telegram agent bridge
├── pyproject.toml              # workspace definition
├── index.html                  # GitHub Pages website
└── CLAUDE.md                   # this file

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

  1. 2d ago First seen · 107 lines · 1,063 tokens per session scan A 1086afb40a65

Subscribe to this mod's changes

cortex CLAUDE.md is an instructions file published in the GitHub repository zzhiyuann/cortex (0 stars, last pushed 5mo ago), licensed MIT. It adds 1,063 tokens to every session, about $0.0053 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.