Overview
ccs-align is an open-source backend skill for Claude Code and compatible agents, published by thedotmack. Its author describes it as: “Run the CCS Align seat's hourly breathing cycle — prove the local claude-mem worker is healthy, pull needle observations through search → timeline → get_observations, land them in a seat-owned middle cache via atomic…”. The project has 94k stars on GitHub and is available under the Apache-2.0 license. Add it to your setup with `/plugin marketplace add thedotmack/claude-mem`.
What ccs-align does
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.
Best for
What’s inside
The SKILL.md for ccs-align is organised into these sections:
- What is implemented (Phases 0–2 shipped)
- What this is NOT (honest boundary)
- Ops MISS — worker plugin version lag
- Prerequisites
- Settings
- Hourly cycle (Appendix A runbook)
- Step 1 — Resolve the port
- Step 2 — Prove worker health (prefer /api/health)
- Step 3 — Pull through the three-layer ladder (in order)
- Step 4 — Grab → append → filter exclude-marks → replace (atomic middle cache)
- Step 5 — Update the cursor
- Step 6 — Speak only on red
Installation
Add ccs-align to your agent with:
/plugin marketplace add thedotmack/claude-mem Review a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
License
ccs-align is published under the Apache-2.0 license.
Strengths
- Clear Apache-2.0 license — safe to read and adapt within its terms
- Ships in thedotmack/claude-mem, an established project with 94,378 GitHub stars
- Works with Claude Code
- Actively maintained — repository updated in the last 30 days
- Its repository gained 544 GitHub stars over the last 7 days
Author
Topics
Frequently asked questions
- What does ccs-align do?
- Run the CCS Align seat's hourly breathing cycle — prove the local claude-mem worker is healthy, pull needle observations through search → timeline → get_observations, land them in a seat-owned middle cache via atomic grab → append → filter exclude-marks → replace, manage exclude marks, and walk house → project → seat rules to detect conflicts (SHADOW_HOUSE, DENY_ALLOW, DRIFT, CLOCK_HEADER) with an append-only rules-report.md. Use when asked to run CCS Align, breathe the alignment seat, refresh the middle cache, exclude or restore an observation, walk rules, check rules conflicts, or check the Worker Watch board.
- How do I install ccs-align?
- Run /plugin marketplace add thedotmack/claude-mem in your agent, then reload your skills. Review the source at https://github.com/thedotmack/claude-mem before installing.
- Is ccs-align free to use?
- Yes. ccs-align is free and open source under the Apache-2.0 license, so you can read, run, and adapt it within that license's terms.
- Which agents does ccs-align work with?
- ccs-align lists Claude Code — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does ccs-align come from?
- ccs-align ships inside thedotmack/claude-mem, a repository that contains 25 catalogued skills in total. The repository's 94,378 GitHub stars apply to that whole collection, not to this skill on its own.