minder-cli 0.5.1

Minder CLI is the command-line interface for the Minder self-hosted MCP platform.

Minder

Minder is a self-hosted MCP (Model Context Protocol) platform for repository-aware engineering intelligence.

It combines a local-first inference stack, a persistent memory and workflow engine, and a developer-facing CLI into a single deployable unit.

What's in this repo

Component	Description
Minder Server	MCP gateway — SSE + stdio transport, RAG pipeline, workflow engine, memory, admin HTTP
Minder CLI (minder-cli on PyPI)	Edge CLI — IDE scaffold, repo sync, login, self-update
Minder Dashboard	Astro admin console — client management, onboarding, skill catalog

Architecture

Developer → minder-cli → Minder Server ←→ AI agents (Codex / Copilot / Claude)
                              │
               ┌──────────────┼──────────────┐
               │              │              │
           MongoDB          Redis         Milvus
         (graph/memory)   (cache)      (vector search)
               │
          ┌─────┴──────┐
          │            │
       llama.cpp    llama.cpp
       (LLM gen)   (embedding)

• LLM inference: llama-cpp-python — GGUF models auto-downloaded from HuggingFace, hardware-accelerated (Metal on Mac, CPU elsewhere)
• Embedding inference: llama-cpp-python — dedicated GGUF embedding model, in-process, no HTTP overhead

Quick Start

Run the server

# 1. Start infra (MongoDB + Redis + Milvus)
docker compose -f docker/docker-compose.local.yml up -d

# 2. Run Minder Server (GGUF models auto-download on first start)
uv run python -m minder.server

Or use the one-command release installer (Docker only, no local uv needed):

curl -fsSL https://raw.githubusercontent.com/hiimtrung/minder/main/scripts/release/install-minder-release.sh | bash

Connect the CLI

# Install
uv tool install minder-cli

# Log in with your client key
minder login --client-key mkc_your_key --server-url http://localhost:8800/sse

# Set up IDE integration (VS Code, Cursor, Claude Code)
minder install-ide --target vscode --target claude-code

# Sync a repository
minder sync --repo-id <uuid>

MCP Tools

When connected, Minder exposes these tools to your AI agents:

Tool	Description
minder_query	Full RAG pipeline: retrieve → reason → verify → respond
minder_search_code	Semantic code search across indexed repos
minder_memory_recall	Retrieve persisted engineering memory
minder_workflow_get	Read current workflow state
minder_session_restore	Restore session continuity across context windows

Documentation

• System Design
• Server Setup
• Local Dev Setup
• Production Deployment
• Admin & Client Onboarding

License

Apache License 2.0. See LICENSE for details.