agentmods.dev

chronoclaude: Instructions file for Claude Code

CLAUDE.md

chronoclaude CLAUDE.md is an instructions file for Claude Code from pleasedodisturb/chronoclaude. It costs 2,596 tokens per session, scanned A, original, MIT.

A project instruction file for Claude Code, an AI coding assistant, describing this repository’s commands, structure, time tracking, toggle layer, and hook lifecycle.

In plain words
What is it for?
Use it when developing or maintaining the Chronoclaude plugin, including running tests, checking versions, measuring token counts, validating the plugin, and reloading local changes.
Why use it?
It gives Claude Code project-specific guidance and records the checks to run before testing, validating, or releasing changes.

Instructions file for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_DATA} variable. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is pleasedodisturb/chronoclaude's own configuration. It tells Claude Code how to work on chronoclaude 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 chronoclaude configures →

not rated 6repo 1mo ago A scan 2,596 tokens original MIT
View source ↗ pleasedodisturb/chronoclaude
Reuse

Borrowing it

Nothing to install: this file belongs to pleasedodisturb/chronoclaude. 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/pleasedodisturb/chronoclaude/master/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/pleasedodisturb/chronoclaude

Made for: Claude Code.

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 chronoclaude CLAUDE.md

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

agentmods 80×15 button for chronoclaude CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/pleasedodisturb/chronoclaude/claude-md"><img src="https://agentmods.dev/badge/instructions/pleasedodisturb/chronoclaude/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,596 This file is loaded in full into every session.
When invoked 2,596 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.02596 $0.02596
Opus 5 $0.01298 $0.01298
Sonnet 5 $0.00519 $0.00519
Haiku 4.5 $0.00260 $0.00260

Measured 9d ago against content hash 28000dad3e0b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

chronoclaude 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 9d 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.

CLAUDE.md · 75 lines

How it starts

The opening of the file, as written. The whole thing — 75 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.

This file does not restate global rules — read ~/.claude/CLAUDE.md first.

Commands

  • npm test — runs node --test tests/*.test.js (128 tests, ~1s).
  • npm run check:version — verifies package.json, .claude-plugin/plugin.json, and .claude-plugin/marketplace.json all carry the same version. CI gate before tagging.
  • npm run prerelease — check:version + full test suite. Run before any git tag v*.
  • npm run tokens (or bun run tokens if bun is available) — prints gpt-tokenizer BPE counts for representative [timing] payloads. Used as a proxy for Anthropic's tokenizer.
  • claude plugin validate . — validates the .claude-plugin/ manifest.
  • claude --plugin-dir . — runs Claude Code with this repo as a local plugin source (development).
  • /reload-plugins (inside Claude Code) — picks up changes after editing scripts in this repo without restarting Claude Code.

To run a single test, target the file directly: node --test tests/state.test.js (or whichever).

Architecture

The plugin gives Claude Code a sense of wall-clock time and idle gaps. It ships four modes coordinated through a single per-session state file at ${CLAUDE_PLUGIN_DATA}/sessions/<sanitized-session-id>.json:

  • Passive — scripts/user-prompt-submit.js injects a hidden [timing] block via the hook's additionalContext. Also emits a visible systemMessage ([after 5m 2s]) when idle exceeds 10s. (These two outputs are independently gated — see Toggle layer.)
  • Active — servers/time-server.js is an MCP server (get_time, time_diff, mark_event, get_timeline) registered via .mcp.json. Hand-rolled JSON-RPC 2.0 over stdio — zero runtime dependencies, no @modelcontextprotocol/sdk. get_timeline merges the in-memory mark_event log with the PostToolUse disk timeline (read via resolveDataDir, falling back to $HOME/.claude/plugins/data/chronoclaude-chronoclaude; optional session_id arg, else most-recent file). Disk reads are wrapped so a failure never breaks the tool.
  • Retrospective — commands/timestamps.md is a slash command that shells out to scripts/parse-transcript.py to render a wall-clock timeline of the current session's .jsonl transcript.
  • Visible — scripts/message-display.js is a MessageDisplay hook that prepends a local-time [HH:MM:SS] marker to the first batch (index === 0) of each assistant message. Display-only — never alters the transcript or what Claude sees. Requires Claude Code 2.1.152+. Adapted from zoharbabin/claude-code-message-timestamps (MIT). The marker is wrapped in an SGR colour (default grey \x1b[90m, reset before the delta so the message text is never recoloured); CLAUDE_TIMING_MESSAGE_DISPLAY_COLOR overrides it (named colour, raw SGR, or none) via messageDisplayColorCode in src/config.js. displayContent renders ANSI per Claude Code docs.

Read the full file on GitHub · 75 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. 9d ago First seen · 75 lines · 2,596 tokens per session scan A 28000dad3e0b

Subscribe to this mod's changes

chronoclaude CLAUDE.md is an instructions file published in the GitHub repository pleasedodisturb/chronoclaude (6 stars, last pushed 1mo ago), licensed MIT. It adds 2,596 tokens to every session, about $0.0130 per session on Opus 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.

Claude Codeclaude-code-pluginclaude-plugindeveloper-toolsmcp
Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 3,735 tokens