ccs-align

ccs-align is a skill for Claude Code, Codex from thedotmack/claude-mem. It costs 136 tokens per session (6,599 once invoked), scanned A, original, Apache-2.0.

An hourly memory-maintenance workflow that checks a local claude-mem worker and copies recent observations into a separate cache. It can mark observations for exclusion and remove excluded records from the compiled cache.

In plain words
What is it for?
Use it to monitor the local memory worker, collect recent observations, deduplicate them, and manage records that should not appear in the cache.
Why use it?
It keeps the cache current without treating every stored observation as useful context. The separate cache and exclusion marks help control what later work can see.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: reads .claude/ paths; mentions CLAUDE.md.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is import { landObservationsInMiddleCache } from '../../src/services/integrations/CcsAlignMiddleCache.js';.

Part of the claude-mem plugin — 17 skills, 1 MCP server shipped together

Good fit Use it to monitor the local memory worker, collect recent observations, deduplicate them, and manage records that should not appear in the cache.

Compare 6 skills from other repositories ↓
About the project

Claude-Mem, now presented as Grok Mem, records an agent's work, compresses it with AI, and brings relevant notes into later sessions so the agent can remember decisions and next steps. It is intended for persistent context across agent conversations and supports multiple coding-agent environments. The catalogue add-ons provide the workflows and integrations used to operate this memory system.

thedotmack/claude-mem · 93,603 stars · on GitHub · claude-mem.ai

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/thedotmack/claude-mem
agentmods
npx agentmods add skills/thedotmack/claude-mem/ccs-align

Made for: Claude Code, Codex.

Or install claude-mem, the plugin that ships this one along with the rest of its 17 skills, 1 MCP server.

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 ccs-align

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/thedotmack/claude-mem/ccs-align"><img src="https://agentmods.dev/badge/skills/thedotmack/claude-mem/ccs-align.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 136 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,599 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. 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.00136 $0.06599
Opus 5 $0.00068 $0.03299
Sonnet 5 $0.00027 $0.01320
Haiku 4.5 $0.00014 $0.00660

Measured yesterday against content hash 4f2553f971ae, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

ccs-align 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 yesterday.

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.

**Resolve the worker port** once and reuse `$WORKER_PORT` in every curl below. This snippet is copied from the `timeline-report` skill and honors `CLAUDE_MEM_WORKER_PORT` → `~/.claude-mem/settings.json` → the per-UID def
plugin/skills/ccs-align/SKILL.md · 438 lines

How it starts

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

CCS Align — Worker Watch seat (Phases 0–2 shipped; Phase 3 = verify / sign-off)

CCS Align is a standing seat, not a bird's-eye planner. Its one job, once an hour: talk to the local claude-mem worker, pull recent needle observations through the existing three-layer disclosure ladder, and land them in a seat-owned middle cache using grab → append → replace.

This skill implements the Phase 0 breathing slice, Phase 1 exclude marks, and Phase 2 rules alignment from the plan of record, plans/2026-09-09-ccs-align.md. Phases 0–2 are shipped and merged (#3934, #3935, #3936); Phase 3 is verify / sign-off (this loop) — no new product surface. It is not a context compiler, not Focus/mouth, and not Grok Memory Phase 2. When you speak to the human, address them as Alex.

What is implemented (Phases 0–2 shipped)

  • Phase 0 — Breathing slice (#3934): health check → searchtimelineget_observations → append records to ~/.claude-mem/ccs-align/<viewerId>/middle.jsonl (atomic, deduped).
  • Phase 1 — Exclude marks (#3935): mark observations (and linked tool-use ids) as excluded from the compiled middle cache. "Purge" means the compiled middle.jsonl no longer contains the record — the diary / SQLite stay authoritative. Unmarking + rebuild restores the observation. DELETE /api/observation/:id is forbidden.
  • Phase 2 — Rules alignment (#3936): walk house → project → seat layers, detect conflicts (SHADOW_HOUSE, DENY_ALLOW, DRIFT, CLOCK_HEADER), emit an append-only rules-report.md. Optionally dry-run/apply SHADOW_HOUSE leaf patches when CLAUDE_MEM_CCS_ALIGN_PATCH_SHADOWS=true. Runs every 6th hour of the hourly Worker Watch cycle (D4). This is a checklist, not a parser — no .cas compiler.
  • Phase 3 — Verify / sign-off (this loop): re-run the regression tests and anti-pattern greps, prove the boundary (a scripted cycle dedupes, an exclude drops from the middle cache but not the diary, the rules report is produced or a MISS is recorded), and keep the skill + plan honest about what this seat is not. Phase 3 adds no new runtime behavior.
  • Does not: delete history, write profile.md, write LFG/Orifice [awareness] logs (that seam belongs to #3931), add a sixth processAgentResponse consumer, restart the worker, run a per-turn drip update, enforce Focus/mouth/standing rules, or copy house text into seats.

Read the full file on GitHub · 438 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. yesterday First seen · 438 lines · 136 tokens per session scan A 4f2553f971ae

Subscribe to this mod's changes

ccs-align is a skill published in the GitHub repository thedotmack/claude-mem (93,603 stars, last pushed today), licensed Apache-2.0. It adds 136 tokens to every session and 6,599 once invoked, about $0.0007 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-09-09.