Skip to main content
Glama
MarcozVD

Basics

by MarcozVD
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Basics

English | Español

CI License: MIT npm

Basics is a personal tech-stack vault: a folder of Markdown notes about the layers, technologies, practices, checks and profiles you use, which your coding agents read and extend over MCP. Notes are plain files (frontmatter + [[wikilinks]], Obsidian- and git-friendly), and every agent write lands in an inbox for you to approve.

Status: 1.0 — see the stability contract.

Quick start

# create a vault with the official packs
npx @marcozvd/basics init ~/basics-vault --yes

# open the local web UI (it also serves MCP over HTTP)
npx @marcozvd/basics --vault ~/basics-vault ui

With the UI running, connect Claude Code:

claude mcp add --transport http basics http://127.0.0.1:4747/mcp

Ask your agent to recommend a stack, then review and approve what it proposes in the Inbox. Other clients (Cursor, VS Code, Codex, OpenCode, Windsurf) are covered in MCP clients.

Related MCP server: memory-vault

What it does

  • A vault you can read — layers, tech, practices, checks, profiles and projects as Markdown notes. No database, no lock-in.

  • Agents that ask first — agent writes become proposals in inbox/ with a reason and a diff; you approve in the CLI or the UI.

  • Recommended stacks — rank technologies per layer from a project description, by keywords or with optional local embeddings.

  • From stack to project — export STACK.md, AGENTS.md, CLAUDE.md and Cursor rules, then run the stack checks in the project.

  • Packs — official starter packs in English and Spanish, plus community packs from any GitHub repo; new notes and updates arrive as inbox proposals, never as silent writes.

  • Local web UI and MCP — a React UI with editor, graph, inbox diff and recommendation playground, plus MCP over HTTP or stdio.

  • Desktop app — the same UI and MCP server running in a standalone, tray-resident window with its own bundled Node runtime; no npm needed. See Desktop app.

  • Agent skill — a SKILL.md that teaches Claude Code, OpenCode or Codex when to call each Basics tool. See Agent skill.

Screenshots (web UI, Inbox diff, graph): coming soon.

Documentation

Full documentation: marcozvd.github.io/basics

Contributions: CONTRIBUTING.md. Security reports: SECURITY.md.

License

MIT — see LICENSE.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Memento Vault

    sandsower
    A
    license
    Not graded
    quality
    A
    maintenance
    Provides persistent knowledge capture and retrieval for coding agents. Enables searching the vault, storing notes, capturing sessions, and reading notes via MCP tools.
    13
    MIT

  • memory-vault

    JohnXu22786
    A
    license
    A
    quality
    B
    maintenance
    Provides cross-session persistent memory for coding agents via MCP tools to store, retrieve, and manage notes with hybrid keyword/semantic search and automatic deduplication.
    8
    201 npm
    MIT