How do I install the Memory Status skill?

Run npx skillmds@latest add troglodyte/memory-status in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Memory Status safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Memory Status?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Memory Status free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Memory Status?

troglodyte (@troglodyte) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Memory Status by troglodyte — Agent Skill

Name: Memory Status
Author: troglodyte

Memory Status

Report the Neo4j memory backend's connection mode (local Docker vs remote), active project scope, and entity/observation counts, or list every project registered in the database with its usage. Use when the user asks whether memory is working, which database it's using, how much has been remembered, what projects are stored in the graph, or how much space/usage each project takes.

troglodyte 085b2a3 3.5 KB Updated Sep 17, 2026

File contents

Two questions land here. Pick the tool that matches which one was asked.

"Is memory working / how much is stored for this project?"

Call the memory_status MCP tool and present the result: connection URI, whether it's running in local or remote mode, the active project scope, and the entity/observation counts.

"What projects are in the database / how much is in each?"

Call the memory_list_projects MCP tool. It returns every project in the graph with its entity count, observation count, and last-activity timestamp — across all projects, not just the current one. Present it as a table sorted by last activity.

For a deeper report, run scripts/memory-usage.sh from the plugin directory. On top of the same table it adds each project's first-seen date, observations in the last 7 days, database totals, and hygiene warnings: projects recorded under two different names (which silently splits one repo's memory in half), entities hoarding 100+ observations, and empty entity stubs. Use --quiet for just the table.

Do not write ad-hoc Cypher for these questions when the tools above answer them.

"This project's subsystem tags are a mess / everything is untagged"

The SessionStart map and npm run usage both surface fragmentation — a junk-drawer tag holding most of the graph, three-observation slivers that should be merged, or a large (untagged) bucket. Every read tool returns each observation's subsystem, and memory_search / memory_recent / memory_timeline accept subsystem: "(untagged)" to enumerate the unclassified ones, so the diagnosis can be made in-session.

Acting on it is a maintenance script, not an MCP tool, because reclassification is an LLM pass over every affected observation: npm run backfill-subsystems tags whatever is currently untagged, and --retag TAG reclassifies observations already carrying a tag (--retag general is how a junk drawer gets emptied). Both take --dry-run to show the proposed tags without writing, and --project NAME to scope to one project. Retagging edits observations in place — ids, timestamps and session links are preserved — so it is safe to re-run and safe to interrupt.

Running arbitrary Cypher

If the user genuinely needs a query the tools do not cover, use scripts/cypher.sh "<query>". It resolves credentials automatically and, in local mode, borrows the cypher-shell binary from inside the Neo4j container — so nothing needs to be installed. It only asks the user to install cypher-shell when connecting to a remote database from a host that lacks it, and even then the memory_* tools and npm run memory -- <cmd> keep working without it. Never tell the user they must install cypher-shell before checking that fallback.

When things fail

If a tool call fails, explain that the Neo4j memory backend is unreachable and point to the plugin's setup: run npm run configure inside the plugin directory, and for local mode make sure the container is running (scripts/setup-local.sh starts it, under Podman or Docker). scripts/check-health.sh diagnoses the whole stack and prints PASS/FAIL per check.

---name: memory-statusdescription: Report the Neo4j memory backend's connection mode (local Docker vs remote), active project scope, and entity/observation counts, or list every project registered in the database with its usage. Use when the user asks whether memory is working, which database it's using, how much has been remembered, what projects are stored in the graph, or how much space/usage each project takes.---Two questions land here. Pick the tool that matches which one was asked.## "Is memory working / how much is stored for *this* project?"Call the `memory_status` MCP tool and present the result: connection URI, whether it's running in local or remote mode, the active project scope, and the entity/observation counts.## "What projects are in the database / how much is in each?"Call the `memory_list_projects` MCP tool. It returns every project in the graph with its entity count, observation count, and last-activity timestamp — across all projects, not just the current one. Present it as a table sorted by last activity.For a deeper report, run `scripts/memory-usage.sh` from the plugin directory. On top of the same table it adds each project's first-seen date, observations in the last 7 days, database totals, and hygiene warnings: projects recorded under two different names (which silently splits one repo's memory in half), entities hoarding 100+ observations, and empty entity stubs. Use `--quiet` for just the table.Do not write ad-hoc Cypher for these questions when the tools above answer them.## "This project's subsystem tags are a mess / everything is untagged"The SessionStart map and `npm run usage` both surface fragmentation — a junk-drawertag holding most of the graph, three-observation slivers that should be merged, or alarge `(untagged)` bucket. Every read tool returns each observation's `subsystem`, and`memory_search` / `memory_recent` / `memory_timeline` accept `subsystem: "(untagged)"`to enumerate the unclassified ones, so the diagnosis can be made in-session.Acting on it is a maintenance script, not an MCP tool, because reclassification is anLLM pass over every affected observation: `npm run backfill-subsystems` tags whateveris currently untagged, and `--retag TAG` reclassifies observations already carrying atag (`--retag general` is how a junk drawer gets emptied). Both take `--dry-run` toshow the proposed tags without writing, and `--project NAME` to scope to one project.Retagging edits observations in place — ids, timestamps and session links arepreserved — so it is safe to re-run and safe to interrupt.## Running arbitrary CypherIf the user genuinely needs a query the tools do not cover, use `scripts/cypher.sh "<query>"`. It resolves credentials automatically and, in local mode, borrows the `cypher-shell` binary from inside the Neo4j container — so **nothing needs to be installed**. It only asks the user to install `cypher-shell` when connecting to a remote database from a host that lacks it, and even then the `memory_*` tools and `npm run memory -- <cmd>` keep working without it. Never tell the user they must install cypher-shell before checking that fallback.## When things failIf a tool call fails, explain that the Neo4j memory backend is unreachable and point to the plugin's setup: run `npm run configure` inside the plugin directory, and for local mode make sure the container is running (`scripts/setup-local.sh` starts it, under Podman or Docker). `scripts/check-health.sh` diagnoses the whole stack and prints PASS/FAIL per check.

Frequently asked questions