Skip to content
Back to search

nemp-memory

MarketplaceWorks with Claude CodeGitHub

Nemp — Agentic memory that evolves with your work. Local project context, decisions and preferences, with agent-guided retrieval and review.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sukinshetty--nemp-memory/badge.svg)](/listings/sukinshetty--nemp-memory)

HTML

<a href="/listings/sukinshetty--nemp-memory"><img src="/api/listings/sukinshetty--nemp-memory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 30 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "nemp-memory",
  4. "description": "Nemp \u2014 Agentic memory that evolves with your work. Local project context, decisions and preferences, with agent-guided retrieval and review.",
  5. "owner": {
  6. "name": "Sukin Shetty",
  7. "email": "contact@nemp.dev"
  8. },
  9. "plugins": [
  10. {
  11. "name": "nemp",
  12. "description": "Nemp \u2014 Agentic memory that evolves with your work. Local project context, decisions and preferences, with agent-guided retrieval and review.",
  13. "version": "0.3.0",
  14. "author": {
  15. "name": "Sukin Shetty",
  16. "email": "contact@nemp.dev"
  17. },
  18. "source": "./",
  19. "category": "productivity",
  20. "homepage": "https://github.com/SukinShetty/Nemp-memory",
  21. "license": "MIT",
  22. "tags": [
  23. "memory",
  24. "persistence",
  25. "context",
  26. "productivity"
  27. ]
  28. }
  29. ]
  30. }
README.md · README · 176 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/logo/Nemp%20Logo.png" alt="Nemp brain-and-chip logo" width="144" />
  3. <h1>Nemp</h1>
  4. <p><strong>Agentic memory that evolves with your work</strong></p>
  5. <p>Keep the decisions, preferences and context your next session needs.<br />Capture what matters. Find it again. Refine it as your work changes.</p>
  6. <p>
  7. <a href=".claude-plugin/plugin.json"><img src="https://img.shields.io/badge/version-0.3.0-7057E8" alt="Version 0.3.0" /></a>
  8. <a href="docs/PRIVACY.md"><img src="https://img.shields.io/badge/storage-local_JSON-347BC4" alt="Storage: local JSON" /></a>
  9. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-239C81" alt="MIT license" /></a>
  10. </p>
  11. <p><a href="#start-with-one-useful-memory">Get started</a> · <a href="docs/COMMANDS.md">Commands</a> · <a href="docs/ARCHITECTURE.md">How it works</a> · <a href="docs/ROADMAP.md">Roadmap</a></p>
  12. </div>
  13. ## Your work moves forward. Your memory should too.
  14. A decision changes. A workaround becomes a rule. Yesterday's assumption stops being true. The next agent session needs the context you still trust, not another copy of an old conversation.
  15. Nemp gives that context a home in local, editable files. Save a decision, retrieve it in a later session, and update the same memory when the project changes. Keep project knowledge in `.nemp/` and reusable preferences in `~/.nemp/`.
  16. **Nemp Open v0.3.0** is the free, MIT-licensed foundation: agent-guided commands, keyword-based retrieval and `CLAUDE.md` sync through the Claude Code integration. The host agent follows Nemp's instructions; Nemp is not a separate background intelligence service.
  17. ## Start with one useful memory
  18. Run these inside **Claude Code**, from your project directory:
  19. ```text
  20. /plugin marketplace add https://github.com/SukinShetty/Nemp-memory
  21. /plugin install nemp@nemp-memory
  22. ```
  23. Restart Claude Code if the new commands aren't available, then:
  24. ```text
  25. /nemp:save api-style "Use REST for the public API; keep GraphQL internal"
  26. /nemp:recall api-style
  27. ```
  28. When the decision changes, save the same key again:
  29. ```text
  30. /nemp:save api-style "Use REST for all APIs; GraphQL retired after the migration"
  31. ```
  32. That is the core loop: **save useful context, use it, keep it current**.
  33. Want a head start? `/nemp:init` detects a JavaScript or TypeScript stack from `package.json`. `/nemp:auto-sync on` enables `CLAUDE.md` updates after supported memory changes. [Full setup guide →](docs/GETTING_STARTED.md)
  34. ## A memory you can work with
  35. <p align="center">
  36. <img src="assets/brand/memory-lifecycle.svg" alt="Capture decisions and preferences, structure them as typed local memories, retrieve relevant context, review what changed, then update or remove it. Repeat as your work evolves." width="100%" />
  37. </p>
  38. | Step | What you do | In Nemp Open |
  39. | :--- | :--- | :--- |
  40. | **Capture** | Keep a decision, convention or useful fact | `/nemp:save` or `/nemp:init` |
  41. | **Structure** | Give it a clear key, concise value and type | Save instructions add metadata and agent attribution |
  42. | **Retrieve** | Find the context for your next task | `/nemp:recall` and `/nemp:context` |
  43. | **Review** | Check what is saved and what needs attention | `/nemp:list`, `/nemp:health`, `/nemp:sync` |
  44. | **Refine** | Update a changed decision or remove obsolete context | Save the same key again, or `/nemp:forget` |
  45. “Evolves” means memory can change alongside the work. Today, this loop is agent-guided and user-directed. Automatic learning, validated corrections and reversible archival are [future work](docs/ROADMAP.md).
  46. ### Built for the things worth carrying forward
  47. - **Decisions with a reason.** Keep the constraint behind a choice, not just the chosen tool
  48. - **Project context.** Start the next session with the stack, conventions and known gotchas
  49. - **Preferences across projects.** Store reusable preferences with `/nemp:save-global`
  50. - **Context you can inspect.** Open the JSON, review recorded activity, and change what is no longer useful
  51. ## What works today
  52. | Capability | Status in this repository |
  53. | :--- | :--- |
  54. | Project and global memory | Save, update, recall, list and delete through host-agent instructions |
  55. | Typed entries and attribution | Type, timestamps and agent metadata; additional tracking fields are present |
  56. | Context search | Keyword expansion across project and global memory; no embedding service |
  57. | `CLAUDE.md` workflow | Manual export, opt-in auto-sync, and import/drift review via `/nemp:sync` |
  58. | Inspection | Access-log viewer and an 80-point diagnostic checklist |
  59. | Activity-based suggestions | Experimental, opt-in capture and suggestion instructions |
  60. | Cross-tool interfaces | Experimental instructions and skill entry points; see [integration status](docs/INTEGRATIONS.md) |
  61. | Nemp Pro | Planned; Cortex, Foresight, Decay and Import are notices in this build |
  62. <details>
  63. <summary><strong>See the existing command demos</strong></summary>
  64. These recordings illustrate earlier command flows. Output and branding may differ from this version; they are not automated test results.
  65. **Initialize project context**
  66. ![Project initialization demo](assets/demos/nemp-init-demo-optimized.gif)
  67. **Find related context**
  68. ![Keyword context search demo](assets/demos/nemp-context-demo.gif)
  69. **Review memory suggestions**
  70. ![Activity-based suggestions demo](assets/demos/nemp-suggest-demo-optimized.gif)
  71. </details>
  72. ## How it works
  73. **Your agent → Nemp instructions → local memory files → context for the next task.**
  74. Nemp's Markdown commands describe how the host agent reads and writes files. The Claude Code plugin supplies the command interface. Nemp Open needs no separate memory server, database, embedding service or memory-service API key.
  75. ```text
  76. Your project/ Your home/
  77. ├── .nemp/ └── .nemp/
  78. │ ├── memories.json └── memories.json
  79. │ ├── MEMORY.md Reusable preferences
  80. │ ├── access.log
  81. │ └── config.json
  82. └── CLAUDE.md
  83. Optional exported context
  84. ```
  85. The experimental activity workflow uses `.nemp-pro/` for its configuration and log. That legacy folder name does not mean Pro is activated.
  86. A memory entry can carry a key, value, timestamps, tags, type and agent attribution. Existing command files use more than one storage shape; a unified schema and migration are still on the roadmap. [Architecture and limitations →](docs/ARCHITECTURE.md)
  87. ## Local memory, clear boundaries
  88. Your saved memory files stay in your project or home directory. Nemp Open does not add a hosted memory backend or telemetry service.
  89. **Local storage does not mean local model processing.** When your host agent reads memory, that content can be processed by its model provider under the host's settings and policies. Review those settings before storing sensitive work.
  90. - Keep secrets, credentials and private client data out of memories and logs
  91. - Review `.nemp/`, `.nemp-pro/` and exported context before sharing or committing them
  92. - Default `/nemp:export` targets Nemp's section; `--replace` overwrites the entire `CLAUDE.md`
  93. - `/nemp:forget` deletes an entry; automatic undo and archival are not included
  94. [Privacy and data handling →](docs/PRIVACY.md)
  95. ## Commands at a glance
  96. | Need | Command |
  97. | :--- | :--- |
  98. | Save or revise context | `/nemp:save <key> <value>` |
  99. | Recall a key or search | `/nemp:recall <key-or-query>` |
  100. | Find related context | `/nemp:context <topic>` |
  101. | Review saved memories | `/nemp:list` |
  102. | Remove a memory | `/nemp:forget <key>` |
  103. | Detect the project stack | `/nemp:init` |
  104. | Export or refresh context | `/nemp:export`, `/nemp:sync` |
  105. | Enable context updates | `/nemp:auto-sync on` |
  106. | Reuse global preferences | `/nemp:save-global`, `/nemp:recall-global`, `/nemp:list-global` |
  107. | Inspect recorded operations | `/nemp:log`, `/nemp:health` |
  108. [Full command reference, including experimental commands →](docs/COMMANDS.md)
  109. ## Nemp Open and the path to Pro
  110. **Open is the foundation.** Local files, explicit memory commands, inspectable context and the freedom to use or modify an MIT-licensed project.
  111. **Pro is the next layer, in development.** The direction is more deliberate memory maintenance: feedback-aware retrieval, source-backed corrections, contradiction review and reversible consolidation or archival. Cross-tool portability is part of that work.
  112. The intended upgrade path is simple: visit [nemp.dev](https://nemp.dev), purchase Pro when available, receive a license key, then use `/nemp:activate` in your terminal agent. Memory storage is intended to remain local. Purchase and license delivery are separate from memory storage.
  113. **This v0.3.0 repository does not implement that purchase, verification or unlock flow.** The Pro notices and activation command explain availability; entering a key here does not unlock unimplemented features. [Roadmap and Pro boundaries →](docs/ROADMAP.md)
  114. ## Explore the repository
  115. - [Getting started](docs/GETTING_STARTED.md) · [Command reference](docs/COMMANDS.md) · [Troubleshooting](docs/TROUBLESHOOTING.md)
  116. - [Architecture](docs/ARCHITECTURE.md) · [Integrations](docs/INTEGRATIONS.md) · [Privacy](docs/PRIVACY.md)
  117. - [Roadmap](docs/ROADMAP.md) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md)
  118. ## Contribute and stay in touch
  119. Help improve command reliability, storage consistency, retrieval mappings and real-world test coverage. Start with the [contribution guide](CONTRIBUTING.md), or [open an issue](https://github.com/SukinShetty/Nemp-memory/issues).
  120. Built by [Sukin Shetty](https://github.com/SukinShetty) · [contact@nemp.dev](mailto:contact@nemp.dev) · [@sukin_s](https://x.com/sukin_s)
  121. [MIT licensed](LICENSE). Keep the context. Keep moving.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.