Skip to main content
Glama

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.

Try it: live demo in your browser, no install · website

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, oh-my-pi, Gemini CLI, Qwen Code, Kimi CLI, Goose, Amp) are covered in MCP clients. Any other agent gets copyable snippets from basics connect --print.

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, Codex and the other agents basics connect sets up when to call each Basics tool. See Agent skill.

An agent proposal reviewed in the Inbox, then a stack recommended and exported

Watch the full two-minute tour (Spanish narration): basics-demo.mp4.

Documentation

Full documentation: marcozvd.github.io/basics

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

License

MIT — see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      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
    • 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
      237 npm
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to save, retrieve, and semantically search code snippets, generate language-specific style guides and comprehensive wiki documentation, and orchestrate multi-agent workflows through discoverable MCP tools.
      -