agentmods.dev

CodexClaw: Instructions file for Codex

AGENTS.md

CodexClaw AGENTS.md is an instructions file for Codex, OpenCode from MackDing/CodexClaw. It costs 649 tokens per session, scanned A, original, MIT.

Repository instructions for CodexClaw, a TypeScript Telegram bot that connects message handling, coding-agent execution, scheduled jobs, and external tools.

In plain words
What is it for?
Use it when changing the bot, its agent runner, Telegram handlers, orchestration code, scheduled tasks, or tests, and when checking whether the application is healthy.
Why use it?
It explains the project layout and the commands used to start, develop, test, type-check, and health-check the bot. This makes routine repository work more predictable.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions Codex.

This is MackDing/CodexClaw's own configuration. It tells Codex and OpenCode how to work on CodexClaw itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything CodexClaw configures →

not rated 34repo +1 3mo ago A scan 649 tokens original MIT
View source ↗ MackDing/CodexClaw opc.ren
Reuse

Borrowing it

Nothing to install: this file belongs to MackDing/CodexClaw. 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/MackDing/CodexClaw/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/MackDing/CodexClaw

Made for: Codex, OpenCode.

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 CodexClaw AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/mackding/codexclaw/agents-md/github.svg)](https://agentmods.dev/instructions/mackding/codexclaw/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/mackding/codexclaw/agents-md"><img src="https://agentmods.dev/badge/instructions/mackding/codexclaw/agents-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.

agentmods 80×15 button for CodexClaw AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/mackding/codexclaw/agents-md"><img src="https://agentmods.dev/badge/instructions/mackding/codexclaw/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 649 This file is loaded in full into every session.
When invoked 649 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 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.1 $0.00649 $0.00649
Opus 5.5 $0.00260 $0.00260
Sonnet 5.5 $0.00130 $0.00130
Haiku 4.5 $0.00065 $0.00065

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

Security

Grade A, and why

CodexClaw AGENTS.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.

AGENTS.md · 59 lines

How it starts

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

Repository Guidelines

Repo Structure

  • src/index.ts: application entrypoint and subsystem wiring.
  • src/bot/: Telegram handlers, formatting, command parsing, i18n, middleware.
  • src/orchestrator/: routing, MCP client, skill registry, GitHub/MCP skills.
  • src/runner/: Codex SDK/CLI runner management, PTY fallback handling, and restricted shell execution.
  • src/cron/: scheduled proactive jobs.
  • tests/: Node built-in test suite, one *.test.js file per module area.

Start And Dev Commands

  • npm install: install dependencies.
  • npm run start: start the Telegram bot with the current .env.
  • npm run dev: run the bot in watch mode for local development.
  • Use CODEX_BACKEND=sdk for the preferred SDK-backed runner; keep CODEX_BACKEND=cli only when you specifically need the legacy PTY/CLI path.

Test Commands

  • npm test: run the full unit test suite with the Node test runner plus tsx.
  • npm run check: run the repository typecheck gate.
  • npm run typecheck: run tsc --noEmit directly.
  • npm run healthcheck: run the local runtime health check.
  • npm run healthcheck:live: run the live Codex + Telegram health probe when local credentials are configured.

Lint And Format

  • npm run lint: run ESLint over source, tests, scripts, and local JS/CJS config files.
  • npm run lint:fix: apply safe ESLint fixes.
  • npm run format: run Prettier across the repository.
  • npm run format:check: verify formatting without writing changes.
  • Do not submit formatting-only churn or rewrap unrelated files.

Files And Paths You Must Not Change

  • Do not edit .git/ or node_modules/.
  • Do not commit or rewrite .env, secrets, Telegram tokens, or local session artifacts.
  • Do not manually edit .codex-telegram-claws-state.json; it is runtime state.
  • Avoid changing files outside this repository root, even when /repo or shell features reference other workspaces.

Contribution Rules

  • Use ES Modules and keep new files under the existing feature-oriented layout.
  • Keep user-facing bot copy in English by default. Localized strings must go through src/bot/i18n.js.
  • Prefer focused changes. Do not mix feature work with unrelated refactors.
  • Add or update tests for behavior changes in tests/.

Read the full file on GitHub · 59 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. 2mo ago First seen · 59 lines · 649 tokens per session scan A c3ff6bdbc834

Subscribe to this mod's changes

CodexClaw AGENTS.md is an instructions file published in the GitHub repository MackDing/CodexClaw (34 stars, last pushed 3mo ago), licensed MIT. It adds 649 tokens to every session, about $0.0026 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-30.

ai-agentcodex-climcpopenai-codextelegram-bot
Related

CodexClaw AGENTS.md compared with instructions from other repositories

CodexClaw AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
CodexClaw AGENTS.mdMackDing/CodexClawInstructions file343mo agoMITA649Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode