Sulcus
Thermodynamic memory for AI agents. Persistent, proactive, intelligent context that doesn't forget.
AI agents forget. Context windows fill up, old facts disappear, and naive RAG pulls irrelevant noise. Sulcus is a persistent, proactive, intelligent memory engine for AI agents. The core idea is simple: treat the prompt window like registers and long-term storage like RAM (a virtual memory management unit for your agent). Every memory carries heat (0.0 to 1.0). New facts start hot, unused ones cool down over time, frequently accessed ones stay warm, just like real memory. Recall doesn't rely on vector similarity alone: it combines semantic search, full-text with phrase proximity, thermodynamic heat, knowledge-graph neighbors, temporal recency, and keyword overlap. What is inside: - Thermodynamic decay: three modes (time-only, interaction-only, hybrid). Ignored memories fade, important ones persist. - Knowledge graph: entities and relationships extracted automatically. Mentioning a topic warms related concepts through the graph. - SIU pipeline: every stored memory passes a quality gate (rejects noise before storage), an automatic type classifier (episodic, semantic, fact, preference, procedural, synthesis), and entity extraction. - Reactive triggers: rules that fire on memory events (store, recall, boost, decay): notify, boost, pin, tag, webhook. Your agent can react to its own memory changes instead of only answering queries. - Context engine: manages the whole context window (constructive assembly, overflow prevention, working-memory cache, session knowledge extraction). Two modes, your choice: 1. Local-only: no credentials, zero network calls. Everything stays in ~/.sulcus/data/ on your machine. 2. Cloud: hosted API at api.sulcus.ca. Requires an API key (get one at sulcus.ca, Dashboard, API Keys). Free tier, no credit card required. Clients available: OpenClaw plugin, npm CLI, Python SDK, Claude Code MCP plugin. Live portal: sulcus.ca. The repository is the open-source client distribution; the server backend is proprietary.
Version:
Quick answer
Sulcus is a persistent memory engine for AI agents. Every memory carries a heat score that cools when unused and warms when accessed, and recall blends semantic search, full-text matching, knowledge-graph neighbors, recency and heat instead of relying on vector similarity alone. It runs local-only on your machine or through a hosted cloud API.
At a glance
| What it is | A thermodynamic memory layer: three decay modes, an automatically extracted knowledge graph, a quality-gated storage pipeline with automatic memory classification, reactive triggers on memory events, and a context engine that manages the whole prompt window. |
|---|---|
| Who it's for | Developers whose agents forget: context windows fill up, old facts disappear, and naive RAG pulls irrelevant noise. |
| What you give it | Your choice of mode — local-only (no credentials, everything stays in ~/.sulcus/data/ on your machine) or cloud (an API key from sulcus.ca) — and the memories your agent stores through the client you pick. |
| What you get | Memories that persist across sessions, fade when ignored and resurface through heat, graph neighbors and recency; stored memories are quality-gated and auto-classified (episodic, semantic, fact, preference, procedural, synthesis), and triggers can notify, boost, pin, tag or fire a webhook on memory events. |
| Works with | Documented clients: an OpenClaw plugin, an npm CLI, a Python SDK and a Claude Code MCP plugin. The repository is the open-source client distribution; the server backend is proprietary. |
| Cost | Free. The cloud mode's hosted API has a free tier that requires no credit card, per the product's documentation. |
| Time | Installation and mode selection up front; afterwards the engine works continuously alongside your agent — decay, recall and triggers run as memories are stored and accessed. |
Example — a fact that stays warm
An example of the documented mechanics at work, not a measured result:
- Your agent stores the fact that a project deadline moved to Friday; the memory starts hot, is auto-classified, and is linked to the project in the knowledge graph.
- Days later a related topic comes up: mentioning it warms the connected concepts, and recall surfaces the deadline through graph neighbors and heat rather than keyword luck.
- Meanwhile, a one-off detail nobody touches keeps cooling under the decay mode you chose, so it stops crowding the context window.
Install
Copy the install package below, then paste it into Muse🧪 Install ran in our test sandbox · Nov 11, 2026📌 Pinned version: commit 1c880c7Install Sulcus, the thermodynamic memory engine for AI agents. Repository (open-source client distribution: SDKs, integrations, plugins, CLI): https://github.com/digitalforgeca/sulcus Pinned version: install the code at commit 1c880c71cb6cecc66edd4b6da2f50f4d30d98971 exactly (Skill Harbor tested this version). Do not substitute a newer version. If this commit is unreachable, stop and tell me. Note: the server backend is proprietary and is NOT in this repo, only the clients are. Prerequisites: Node 18+ (npm CLI / OpenClaw plugin) or Python 3.10+ (Python SDK). No database to set up, local mode embeds everything. Two modes (explain both, then default to LOCAL-ONLY unless I say otherwise): 1. Local-only: no credentials, zero network calls. Memory stays in ~/.sulcus/data/ on my machine. 2. Cloud: hosted API. I need an API key from https://sulcus.ca (Dashboard, API Keys); configure serverUrl https://api.sulcus.ca with my key. Free tier, no credit card required. Steps: pick the client that fits my setup (OpenClaw plugin via `openclaw plugin install openclaw-sulcus`, npm CLI via `npm install -g sulcus-cli`, Python SDK, or the Claude Code MCP plugin), install it, configure the chosen mode, then verify with a store + recall round-trip (store a test fact, recall it, delete it) and show me it working. Report what you installed, where the config lives, and which mode is active. Never send my memory content anywhere without telling me first.
Saved to your recent installs. Find it anytime on /connect.
🔒 Security, provenance and what this touches
- It can contact outside services over the network.
- It can download and install software packages.
- It works with an API key or a token that you provide.
What the scan found — excerpts from the install prompt
- makes network calls — 2. Cloud: hosted API. I need an API key from https://sulcus.ca (Dashboard, API Keys); configure serverUrl http · 2. Cloud : API hébergée. J'ai besoin d'une clé API de https://sulcus.ca (Dashboard, API Keys) ; configure serv
- installs packages — Steps: pick the client that fits my setup (OpenClaw plugin via `openclaw plugin install openclaw-sulcus`, npm · Étapes : choisis le client adapté à mon setup (plugin OpenClaw via `openclaw plugin install openclaw-sulcus`,
- uses API keys or tokens — 2. Cloud: hosted API. I need an API key from https://sulcus.ca (Dashboard, API Keys); configure serverUrl http · 2. Cloud : API hébergée. J'ai besoin d'une clé API de https://sulcus.ca (Dashboard, API Keys) ; configure serv
The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?
Verification certificate
Dated facts about what was checked for this listing, and how. This is not a safety certification.
- Pinned version
- 1c880c7 · 2026-10-13
- Sandbox install test
- Install ran in our test sandbox · Nov 11, 2026 · Observed during the install test: registry.npmjs.org
- Creator identity
- Not verified
- Fingerprint watch
- Last checked · Nov 19, 2026 : no change detected in the files linked by this install prompt
- Install prompt analysis
- 2026-10-13 : makes network calls · installs packages · uses API keys or tokens
Skill Harbor never reviews the code of a listed skill. These are dated facts about the install prompt and our install test, not a safety certification. Review a skill yourself before you install it. How we verify
Questions
How do I install a skill?
Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the skill up for you — no manual configuration.
Where does my money go?
Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.
What does the ✓ next to a creator’s name mean?
It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a skill before installing it.