Elen

com.learningnodesPublished by learningnodes.comv0.3.1Updated Nov 4, 2026

Records coding-agent decisions with their limits and marks old ones superseded. Local SQLite.

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Elen records a coding agent's technical decisions with their constraints in a local SQLite graph, and lets the assistant search, expand and supersede them…

What you can do
  • Commit and log decisions with their constraints, evidence and answer
  • Retrieve short pointers to prior decisions and expand a decision ID into full constraints and text
  • Search validated decisions for precedents, including team and human decisions in connected mode
  • Revise an older decision and mark it superseded by a new one
  • Review active decision threads by domain, competency profile, consolidation suggestions and database status
When to use it
Useful when you want a coding agent to check earlier architectural or technical decisions before making new ones and to keep a durable, queryable record of why choices were made. Best suited to long-running projects where precedents and their limits matter across sessions.
Requirements
Runs locally over stdio via npx from the npm package @learningnodes/elen-mcp; needs Node.js and an MCP client such as Claude Code, Cursor, VS Code or Gemini CLI. Decisions are stored in a local SQLite file, by default under the user's home directory. The optional connected mode requires an Elen login and API key.
Before you install
The server writes and revises records in a local SQLite database, and superseding changes the state of existing decisions. Connected mode is in beta, needs an API key, and shares decisions with a workspace, so team and incoming decisions come from other people. The README notes that only Claude Code is recorded as tested; other client configurations are untested. The project is AGPL-3.0 licensed and the README links to a commercial workspace.

Installation

In SourceWeft

  1. Open Elen in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Elen is an open-source MCP server that records the decisions your coding agent makes, with the limits that bound them, and marks old decisions as superseded. It installs with one npx line, works with Cursor, Claude Code and any MCP client, and keeps decisions in a local SQLite file.

Install

bash
npx -y @learningnodes/[email protected]

Claude Code

bash
claude mcp add --transport stdio elen -- npx -y @learningnodes/[email protected]

VS Code

Open this link to install:

vscode:mcp/install?%7B%22name%22%3A%22elen%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40learningnodes%2Felen-mcp%400.3.1%22%5D%7D

Cursor

Add this to .cursor/mcp.json in your project:

json
{  "mcpServers": {    "elen": {      "command": "npx",      "args": ["-y", "@learningnodes/[email protected]"]    }  }}

Gemini CLI

Add this to settings.json (~/.gemini/settings.json, or .gemini/settings.json in your project):

json
{  "mcpServers": {    "elen": {      "command": "npx",      "args": ["-y", "@learningnodes/[email protected]"]    }  }}

Any other MCP client

Use the same mcpServers entry:

json
{  "mcpServers": {    "elen": {      "command": "npx",      "args": ["-y", "@learningnodes/[email protected]"]    }  }}

Tested with

ClientStatus
Claude CodeRun by the maintainer
CursorConfiguration follows the client's documentation. Not yet recorded as tested.
VS CodeConfiguration follows the client's documentation. Not yet recorded as tested.
Gemini CLIConfiguration follows the client's documentation. Not yet recorded as tested.
Other MCP clientsConfiguration follows the client's documentation. Not yet recorded as tested.

Make your agent use it

The tools alone give an agent no habit: it sees what each tool does, but it does not stop mid-task to ask whether a precedent exists. Add the block below to your rules file or system prompt so that searching before a decision and committing after one become part of every session.

markdown
# Epistemic Decision Memory Protocol
You must adhere to the Minimal Token Protocol for decisions:
1. Pointer-First Retrieval: Before making a technical decision, ALWAYS use elen_suggest to retrieve Top-K minimal pointers.2. On-Demand Expansion: If a pointer looks relevant, you MUST call elen_expand on that specific ID. Do not hallucinate constraints.3. Commiting Atoms: When deciding, use elen_commit. Summarize constraints into plain-text arrays (e.g. "budget < 500ms").4. Graph Revision: If a decision invalidates a precedent, you MUST use elen_supersede to advance the graph state.

What it stores

In local mode decisions stay in a SQLite file on your machine (default ~/.elen/decisions.db). Connected mode is optional, needs elen login and an API key, and is in beta.

Tools

ToolWhat it does
elen_commitCommits a new decision to the graph, with its constraints as a plain-text list.
elen_get_competencyShows the competency profile for this agent, built from its validated decision history.
elen_consolidateSuggests clusters and duplicate or stale candidates without changing the graph.
elen_get_contextGives an overview of active decision threads grouped by domain, for the start of a session.
elen_expandExpands a decision ID into its full constraints and text.
elen_incomingLists decisions other people have shared into your workspace. Connected mode, beta.
elen_log_decisionCreates a validated Decision Record from constraints, evidence and an answer.
elen_search_precedentsSearches validated decisions for precedents.
elen_statusReturns the agent, project, database path and counts, to check the namespace before committing.
elen_suggestRetrieves short pointers to prior decisions before you make a new one.
elen_supersedeRevises an older decision and marks it superseded by a new one.
elen_team_searchSearches team and human decisions visible to your workspace for a topic. Connected mode, beta.

Links

Elen is the open-source part of Learning Nodes, the DecisionOps workspace. For the business decisions behind the code: https://workstation.learningnodes.com?utm_source=elen-readme&utm_medium=referral&utm_campaign=npm-page

Source: packages/mcp-server/README.md at commit 6ed6c0f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.1LatestOct 14, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts