← Back to Skills Marketplace
widingmarcus-cyber

MindGardener

by Marcus Widing · GitHub ↗ · v1.1.0
cross-platform ✓ Security Clean
739
Downloads
2
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install mindgardener
Description
Local-first long-term memory for autonomous agents. Built for OpenClaw. Creates wiki knowledge graph from conversations, scores events by surprise, detects c...
Usage Guidance
MindGardener is a local file-backed memory tool that matches its description, but review these before installing: 1) Confirm you want a CLI that will create and write to workspace/memory/, memory/entities/, graph.jsonl and MEMORY.md (these are the main artifacts). 2) If you don't want external LLM calls, set provider to a local model (Ollama) in garden.yaml — otherwise you'll need to export API keys (GEMINI_API_KEY/OPENAI_API_KEY/ANTHROPIC_API_KEY) yourself. 3) Do not copy the example nightly-cycle.sh verbatim: it references absolute paths (/root/clawd) and an external auto-recall.py; adapt paths and inspect any referenced scripts. 4) If you enable multi-agent sync or integrations that post to channels (#state-tracker, discord, etc.), audit the sync/posting code paths to confirm where data is transmitted and to which endpoints. 5) Because the package writes human-readable markdown files, you can inspect and version-control (git) the memory directory; test in an isolated workspace first if you want to audit behavior before using with real data.
Capability Analysis
Type: OpenClaw Skill Name: mindgardener Version: 1.1.0 The MindGardener (also referred to as Engram) skill bundle is a sophisticated long-term memory system for AI agents that uses local Markdown files and knowledge graphs. It implements advanced features like 'surprise scoring' (prediction error) to consolidate memories, temporal decay, and identity-level belief tracking. The code is well-structured, modular, and includes an extensive test suite. All high-risk behaviors, such as network calls to LLM providers (Google, OpenAI, Anthropic) and local file manipulation, are strictly aligned with the stated purpose of extracting and retrieving agent memories. No evidence of data exfiltration, backdoors, or malicious prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the delivered artifacts: a CLI named 'garden' (entrypoint engram.cli) and Python package code that builds a file-backed memory/wiki and performs surprise scoring. Declared required binary 'garden' is consistent with the package's console script. Minor mismatch: registry metadata said "No install spec / instruction-only" while SKILL.md includes a pip install entry and the repository includes full source — the presence of source + a pip install instruction is coherent (you can pip install or use included code) but the registry's "instruction-only" statement is inaccurate.
Instruction Scope
SKILL.md and README are explicit: the tool writes/reads markdown under a workspace (memory/, memory/entities/, graph.jsonl, MEMORY.md), runs three LLM-backed commands (extract, surprise, consolidate) and many file-only commands. The runtime instructions ask users to add cron jobs and inject RECALL-CONTEXT.md at session start. A few example artifacts (nightly-cycle.sh) reference absolute /root/clawd paths and invoke external scripts (python3 /root/clawd/tools/auto-recall.py) — these are examples, not automatic behavior, but you should review and adapt them before copying into system cron. The docs mention posting conflicts to a #state-tracker channel and accept provenance sources like discord/twitter/url — the code paths for external posting are not obvious in the truncated files, so verify the sync/posting implementation if you plan to enable multi-agent sync.
Install Mechanism
No high-risk network install (the SDK is provided as a pip package and the SKILL.md suggests pip install mindgardener). The package includes source and a standard pyproject with 'garden' console script. There is no evidence of opaque remote downloads or URL-based extract/install operations in the provided manifest. The only install suggestion is via pip (standard registry).
Credentials
The skill declares no required environment variables, which is reasonable for local operation. However, several operations optionally call LLM providers and the README/SKILL.md instructs users to set provider API keys (GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY) if using cloud providers. Those are optional and documented. Because the tool can run fully local with a local provider (Ollama), the lack of required env vars is proportionate — but you should be aware that enabling cloud providers will require you to supply API keys yourself. Also review any sync integrations before enabling (they may require network endpoints).
Persistence & Privilege
The skill does not request always:true or any elevated platform-wide privileges. It operates by writing files into the configured workspace (memory/ folder) and creating garden.yaml and MEMORY.md. That file I/O is expected for a local-first memory tool. Example cron scripts are user-provided; nothing indicates it will auto-enable itself across agents or modify other skills' configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mindgardener
  3. After installation, invoke the skill by name or use /mindgardener
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1.0: Built for OpenClaw. Provenance, conflicts, auto-inject, decay, multi-agent sync.
v1.0.1
Fix security scan: declare install mechanism, env vars, and data flow transparency. Clarify which commands are local-only vs LLM-calling.
v1.0.0
v3: identity-level consolidation, token-budget context assembly, fact-check evaluator, 177 tests, 15 CLI commands. Your agents forget everything — this fixes it.
Metadata
Slug mindgardener
Version 1.1.0
License
All-time Installs 2
Active Installs 2
Total Versions 3
Frequently Asked Questions

What is MindGardener?

Local-first long-term memory for autonomous agents. Built for OpenClaw. Creates wiki knowledge graph from conversations, scores events by surprise, detects c... It is an AI Agent Skill for Claude Code / OpenClaw, with 739 downloads so far.

How do I install MindGardener?

Run "/install mindgardener" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is MindGardener free?

Yes, MindGardener is completely free (open-source). You can download, install and use it at no cost.

Which platforms does MindGardener support?

MindGardener is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created MindGardener?

It is built and maintained by Marcus Widing (@widingmarcus-cyber); the current version is v1.1.0.

💬 Comments