cachly

n8n community node for the cachly AI Brain: store lessons, recall them and keep working notes, also as a tool for AI agents.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Heinrich Neb

Available Nodes

Documentation generating…

Documentation

n8n-nodes-cachly

n8n community node for the cachly AI Brain. It stores lessons, looks them up again and keeps short working notes. It can also be used as a tool by an AI agent in n8n.

Version 1 has actions only. There is no memory connector for the AI Agent node yet.

Install

In n8n: Settings, Community Nodes, Install, then enter @cachly-dev/n8n-nodes-cachly.

To let an AI Agent use the node as a tool, start n8n with N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true.

Credentials

Create a credential of type "Cachly API":

Field Meaning
Instance ID ID (UUID) of your Brain instance, shown in the cachly dashboard
API Key cachly API key (cky_...), sent as Authorization: Bearer <key>
API URL Default https://api.cachly.dev. Only change it for a self-hosted API.

The credential test calls GET /api/v1/instances/<Instance ID>.

Operations

Operation Like MCP tool REST call
Learn learn_from_attempts POST /api/v1/instances/{id}/learn
Recall smart_recall (reduced, see below) POST /api/v1/instances/{id}/recall
Remember Context remember_context POST /api/v1/instances/{id}/context

Fields:

  • Learn: topic, outcome (success, partial, failure), what_worked (required unless the outcome is failure), optional what_failed, context, severity, tags, commands, file_paths, author. Put the key fact first in what_worked: only the first characters appear in briefings.
  • Recall: query (words), limit (1 to 25, API default 8). The REST endpoint filters by words. It does not run the semantic search of the MCP tool smart_recall. Each recall counts against the monthly recall quota of your plan.
  • Remember Context: key, content (cut after 4096 characters), ttl in seconds (default 86400, values above 7 days fall back to 24 hours). The note is stored as cachly:ctx:wip:<key>. The REST endpoint always uses the category wip; the MCP tool allows other categories.

The API redacts secrets in lessons sent to /learn and flags suspicious instructions (api/internal/handler/instance_handler.go, Learn).

Development

npm install --ignore-scripts   # n8n-workflow pulls a native module that is not needed here
npm test
npm run lint
npm run build

Licence

MIT. The package layout follows the n8n community node starter. The structure was inspired by the MIT-licensed postiz-n8n; no code from Postiz itself is used.

Discussion