@xcraftmind/mastermind

Local-first repository context for coding agents: codegraph, cited project knowledge, change impact, and evidence-backed workflows.
7,638 13
vue ai cli mcp rust claude tree-sitter codegraph indexer mastermind
Install
npm install @xcraftmind/mastermind
Latest Version:3.4.1
License:MIT
Last Updated:Oct 22, 2026
Links: GitHub  ·  npm
Maintainer: 0xcraft

@xcraftmind/mastermind

npm version 3.4.1 CI status MIT license

Local repository context and task-evidence workflows for coding agents. The package supplies a prebuilt binary as mastermind and mmcg. It indexes source code, Markdown documentation, and Vue SFC script blocks with source-backed symbols and relationships.

Quick start

Requires Node.js 24+. Run inside your repository:

npm install -g @xcraftmind/mastermind
mastermind init

The first run detects the active client, or installed Claude Code and Codex clients. It scaffolds and indexes the project, installs workflows, enables the profile and uses --mining task. The current agent proposes preference drafts, saved locally after complete capture without a separate model request. Use --client none for local indexing only. Choices are saved in .mastermind/setup.json.

Command Purpose
mastermind status --json Inspect component state and the next task action
mastermind update Update in the existing npm scope and refresh installed workflows
mastermind update --dry-run Preview locally without changes or network calls
mastermind ui --since main Open a read-only review against your Git baseline
mastermind --help Show onboarding and project commands
mmcg --help Show the complete native CLI

Restart the selected client and review its generated definitions in /hooks. Registration does not establish client trust or a live connection. Use --mining capture for collection without semantic analysis or --profile-access off to disable profile delivery. Added task context and tools consume the current client's usage. Drafts require review. Existing npm hooks use the package launcher after updates.

Platform Support
macOS arm64 or x64 Prebuilt native tools, hooks, and managed mining
Linux arm64 or x64, glibc or musl Prebuilt native tools, hooks, and managed mining
Windows x64 Local indexing and client setup with --mining off
Rust toolchain Not required for this package

Native hooks and managed mining are unsupported on Windows. See the package manifest for binary packages.

Documentation

Guide Covers
Getting started Setup, mining modes, updates and alternative installations
Personal profile Capture, candidate review and optional separate analysis
Architecture Context layers and evidence boundaries
Task workflow Scope, checks, review, and completion
CLI and MCP reference Native commands, tools, and language coverage
Client integrations Advanced setup, scope, and removal

Cargo package: mmcg. License: MIT.

Related Packages

@sunpix/claude-code-web

A web-based interface for interacting with Claude Code CLI

1,564 78
ai claude cli vue claude-code nuxt web-interface
@wot-ui/cli

面向 wot-ui 的 CLI、MCP 与数据提取工具集

5,482 38
ai cli mcp vue coding-agent model-context-protocol uni-app wot-ui
@ray_of_goodness_/docmap

AI-agent-agnostic documentation-map generator for FE/BE codebases

3,325
ai claude cli codex docs documentation gemini magento2 nuxt
@siemens/ix-mcp-vue

iX MCP server for Vue

20,690
ai mcp ix
@vuetify/mcp-cli

Vuetify MCP CLI

422 9
cli mcp vuetify

Version History

Version Released License
3.4.1 MIT
3.4.0 MIT
3.3.1 MIT
3.3.0 MIT
3.2.4 MIT