What is claude-code-sessions CLAUDE.md?

A development guide for an open-source session-management project with reusable JavaScript packages and a web interface. A monorepo is one repository that contains several related packages, such as its core library and web app.

Use it when changing the session library or web interface, updating versions, writing English project content, or preparing signed commits and releases.

It clarifies project structure and requires confirmation before actions that create permanent public records, such as GitHub changes, pushes, or publishing packages.

How es6kr/claude-code-sessions configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to es6kr/claude-code-sessions. 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/es6kr/claude-code-sessions/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/es6kr/claude-code-sessions

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/es6kr/claude-code-sessions/claude-md/github.svg)](https://agentmods.dev/instructions/es6kr/claude-code-sessions/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/es6kr/claude-code-sessions/claude-md"><img src="https://agentmods.dev/badge/instructions/es6kr/claude-code-sessions/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/es6kr/claude-code-sessions/claude-md"><img src="https://agentmods.dev/badge/instructions/es6kr/claude-code-sessions/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 981 This file is loaded in full into every session.

When invoked 981 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.

Model	Per session	Once invoked
Fable 5.1	$0.00981	$0.00981
Opus 5.5	$0.00392	$0.00392
Sonnet 5.5	$0.00196	$0.00196
Haiku 4.5	$0.00098	$0.00098

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

Security

Grade A, and why

claude-code-sessions 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 1mo 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 · 125 lines

How it starts

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

CLAUDE.md

Claude Code sessions monorepo - Effect-TS based session management library

Project Structure

packages/core - Core library (npm: @claude-sessions/core)
packages/web - SvelteKit web UI (npm: @claude-sessions/web)

Important: Open Source Project

This is an English-only open source project:

All code comments, variable names, commit messages in English
Documentation in English
Include -s flag when committing (sign-off)

Development Workflow

Permanent Records & Public Actions Policy

CRITICAL: GitHub comments, PR/Issue modifications, and Git pushes leave permanent traces that cannot be fully erased (e.g., "comment deleted" logs). ALWAYS use notify_user (or AskUserQuestion) to get explicit confirmation BEFORE:

GitHub API Actions: Posting or editing comments, labels, milestones, or issue states.
Git Push: Amending commits, force pushing, or pushing corrections for previous mistakes.
VSIX/NPM Publishing: Any action that results in a new public artifact version.
Workflow Changes: Modifying CI/CD pipelines or branch protection rules.

Version Management

Always use npm version command for version bumps:

# Patch version (0.1.5 -> 0.1.6)
pnpm version patch

# Minor version (0.1.5 -> 0.2.0)
pnpm version minor

# Specific version
pnpm version 0.2.0

Web UI Testing

After modifying web features, always test with Playwright:

Start dev server: pnpm dev
Test functionality with Playwright
Keep browser open for user verification (don't close)

Refactoring

리팩토링 시 refactor-comparison 에이전트 사용 → 순수함수 vs Effect 비교 분석

Session Summary Architecture

CRITICAL: Understanding how summaries work is essential for matching official extension behavior.

Summary records have leafUuid but no timestamp
leafUuid points to a message in another session (cross-session reference)
The timestamp for sorting/display must be derived from the target message's timestamp
Official extension calculates relative time based on leafUuid's target message timestamp

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

1mo ago First seen · 125 lines · 981 tokens per session scan A fbb3a9615faf

Subscribe to this mod's changes

claude-code-sessions CLAUDE.md is an instructions file published in the GitHub repository es6kr/claude-code-sessions (22 stars, last pushed yesterday), licensed MIT. It adds 981 tokens to every session, about $0.0039 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.

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 · 9,649 tokens

claude-code-sessions: Instructions file for Claude Code