minder-cli 0.5.8__tar.gz → 0.6.0__tar.gz

minder_cli-0.6.0/.gitignore

@@ -0,0 +1,37 @@
+__pycache__
+*.pyc
+*.pyo
+.env
+.venv
+.pytest_cache
+.coverage
+.mypy_cache
+.ruff_cache
+.uv-cache
+ref
+
+# Profiling artifacts
+*.profraw
+*.profdata
+
+# Temp / scratch
+tmp/
+scratch/
+scratch*.py
+smoke_check*.py
+check_output*.txt
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+node_modules
+.astro
+
+.cursor
+.codex
+.claude
+.minder
+.mcp.json
+.vscode

minder_cli-0.6.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: minder-cli
+Version: 0.6.0
+Summary: Minder CLI is the command-line interface for the Minder self-hosted MCP platform.
+Project-URL: Homepage, https://github.com/hiimtrung/minder
+Project-URL: Repository, https://github.com/hiimtrung/minder
+Project-URL: Documentation, https://github.com/hiimtrung/minder/tree/main/docs
+License-File: LICENSE
+Keywords: ai,cli,code-search,mcp,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.14
+Requires-Dist: fastapi>=0.136.0
+Requires-Dist: httpx>=0.28.0
+Provides-Extra: server
+Requires-Dist: aiosqlite>=0.21.0; extra == 'server'
+Requires-Dist: langgraph>=1.1.8; extra == 'server'
+Requires-Dist: litellm>=1.83.1; extra == 'server'
+Requires-Dist: llama-cpp-python>=0.3.7; extra == 'server'
+Requires-Dist: mcp>=1.26.0; extra == 'server'
+Requires-Dist: passlib[bcrypt]>=1.7.4; extra == 'server'
+Requires-Dist: prometheus-client>=0.24.1; extra == 'server'
+Requires-Dist: pydantic-settings[toml]>=2.13.1; extra == 'server'
+Requires-Dist: pydantic>=2.12.5; extra == 'server'
+Requires-Dist: pyjwt>=2.12.1; extra == 'server'
+Requires-Dist: qdrant-client>=1.14.0; extra == 'server'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.49; extra == 'server'
+Requires-Dist: yarl>=1.16.0; extra == 'server'
+Requires-Dist: zipp>=3.21.0; extra == 'server'
+Requires-Dist: zstandard>=0.25.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# Minder
+
+[![PyPI version](https://img.shields.io/pypi/v/minder-cli.svg)](https://pypi.org/project/minder-cli/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+**Minder** is a self-hosted MCP (Model Context Protocol) platform for repository-aware engineering intelligence.
+
+It combines an LLM inference stack, a persistent memory and workflow engine, a browser admin console, and a lightweight CLI into a single deployable unit.
+
+## What's in this repo
+
+| Component                             | Description                                                                                           |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| **Minder Server**                     | MCP gateway — SSE + streamable HTTP + stdio, RAG pipeline, workflow engine, memory, admin HTTP        |
+| **Minder Dashboard**                  | Astro admin console — client management, onboarding snippets, agent instructions, skill catalog, chat |
+| **Minder CLI** (`minder-cli` on PyPI) | Edge CLI — repo sync, MCP config install, login, self-update                                          |
+
+## Architecture
+
+```
+Developer workstation
+  ├── minder-cli          repo sync, MCP config
+  └── AI agent (IDE)  ──► Minder Server :8800
+                              │
+                    ┌──────────────┼──────────────────────┐
+                    │              │                      │
+                 Qdrant   SQLite / PostgreSQL    llama-cpp-python
+          (default vector +   (optional relational/   (LLM + embedding,
+           operational data)    graph adapters)        GGUF on host)
+```
+
+- **Transport**: SSE (`/sse`), streamable HTTP (`/mcp`), stdio
+- **LLM inference**: llama-cpp-python with GGUF models auto-downloaded from HuggingFace (Metal on Mac, CPU elsewhere)
+- **Vector search**: Qdrant for semantic retrieval
+- **Operational storage**: Qdrant by default, with optional SQLite/PostgreSQL adapters for relational and graph workloads
+
+## Quick Start
+
+### 1. Run the server
+
+```bash
+# Start infra (Qdrant)
+docker compose -f docker/docker-compose.local.yml up -d
+
+# Run Minder Server (GGUF models auto-download on first start)
+uv run python scripts/dev_server.py
+```
+
+Or use the one-command release installer (Docker only):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/hiimtrung/minder/main/scripts/release/install-minder-release.sh | bash
+```
+
+### 2. Open the dashboard
+
+```
+http://localhost:8800/dashboard
+```
+
+First run → `/dashboard/setup` to create an admin and get your `mk_...` key.
+
+### 3. Create a client and connect your IDE
+
+1. Open `/dashboard/clients` → create a client → save the `mkc_...` key (shown once in a modal)
+2. Open the client detail → copy the MCP snippet for your IDE from **Copy-ready MCP snippets**
+3. Open `/dashboard/instruction` → copy the agent orchestration rules for your IDE
+
+### 4. Install the CLI and sync a repository
+
+```bash
+# Install
+uv tool install minder-cli
+
+# Log in
+minder login --client-key mkc_your_key --server-url http://localhost:8800/sse
+
+# Write MCP config to your IDE (optional — dashboard shows it too)
+minder install --target vscode --target claude-code
+
+# Sync a repository
+minder sync
+```
+
+## 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_search_errors`                                                     | Look up past error patterns                             |
+| `minder_find_impact`                                                       | Find what a change might affect                         |
+| `minder_memory_store` / `minder_memory_recall`                             | Persistent engineering memory                           |
+| `minder_session_create` / `minder_session_save` / `minder_session_restore` | Cross-machine session continuity                        |
+| `minder_workflow_get` / `minder_workflow_step` / `minder_workflow_guard`   | Workflow governance                                     |
+| `minder_skill_store` / `minder_skill_recall`                               | Reusable pattern catalog                                |
+| `minder_agent_list` / `minder_agent_get`                                   | SubAgent registry                                       |
+
+## Dashboard Pages
+
+| Route                      | Description                                                                      |
+| -------------------------- | -------------------------------------------------------------------------------- |
+| `/dashboard`               | Home — stats and quick nav                                                       |
+| `/dashboard/clients`       | Create clients, copy MCP snippets                                                |
+| `/dashboard/instruction`   | Agent orchestration rules — copy for Claude Code, Cursor, VS Code, Codex |
+| `/dashboard/sessions`      | LLM session management                                                           |
+| `/dashboard/memories`      | Persistent memory browser                                                        |
+| `/dashboard/skills`        | Skill / pattern catalog                                                          |
+| `/dashboard/agents`        | SubAgent registry                                                                |
+| `/dashboard/chat`          | Browser-based runtime chat                                                       |
+| `/dashboard/repositories`  | Repo graph explorer                                                              |
+| `/dashboard/workflows`     | Workflow definitions                                                             |
+| `/dashboard/observability` | Audit and trace                                                                  |
+
+## Documentation
+
+- [System Design](docs/architecture/system-design.md)
+- [Local Dev Setup](docs/guides/local-setup.md)
+- [Production Deployment](docs/guides/production-deployment.md)
+- [Admin & Client Onboarding](docs/guides/admin-client-onboarding.md)
+- [Minder CLI](docs/guides/minder-cli.md)
+
+## License
+
+Apache License 2.0. See [LICENSE](LICENSE) for details.

{minder_cli-0.5.8 → minder_cli-0.6.0}/README-pypi.md

@@ -5,7 +5,7 @@
 
 **minder-cli** is the command-line interface for [Minder](https://github.com/hiimtrung/minder) — a self-hosted MCP platform for repository-aware engineering intelligence.
 
-The CLI handles IDE scaffolding, repository sync, authentication, and self-updates. It connects to a **Minder Server** which runs the MCP gateway, RAG pipeline, memory engine, and admin console.
+The CLI handles repository sync, MCP config installation, authentication, and self-updates. It connects to a **Minder Server** which runs the MCP gateway, RAG pipeline, memory engine, and admin dashboard.
 
 ## Installation
 
@@ -19,61 +19,64 @@ pipx install minder-cli
 
 ## Requirements
 
-A running [Minder Server](https://github.com/hiimtrung/minder) — see the [server setup guide](https://github.com/hiimtrung/minder/blob/main/docs/minder-server.md) to get one running in minutes with Docker.
+A running [Minder Server](https://github.com/hiimtrung/minder) — see the [server setup guide](https://github.com/hiimtrung/minder/blob/main/docs/guides/local-setup.md) to get one running with Docker.
 
 ## Quick Start
 
-### 1. Connect to your server
+### 1. Authenticate
 
 ```bash
 minder login --client-key mkc_your_client_key --server-url http://localhost:8800/sse
 ```
 
-### 2. Set up IDE integration
+Create a client and get your `mkc_...` key from the dashboard at `/dashboard/clients`.
+
+### 2. Write MCP config to your IDE (optional)
 
 ```bash
-# In your project root — scaffolds MCP config for your editor
-minder install-ide --target vscode --target claude-code
+minder install --target vscode --target claude-code
 ```
 
-Supported targets: `vscode`, `cursor`, `claude-code`.
+MCP snippets and agent instructions are also available from the Minder dashboard at `/dashboard/clients` and `/dashboard/instruction` — no CLI install required.
 
 ### 3. Sync a repository
 
 ```bash
-minder sync --repo-id <repository-uuid>
+minder sync
 ```
 
-Indexes code and documentation so AI agents can use semantic search and RAG tools.
+Indexes code and documentation so AI agents can use semantic search and knowledge-graph tools.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `minder login` | Authenticate the CLI against a Minder Server |
-| `minder install-ide` | Scaffold MCP assets for VS Code / Cursor / Claude Code |
+| `minder install` | Write MCP server config into IDE config files |
+| `minder uninstall` | Remove MCP server config from IDE config files |
 | `minder sync` | Index a repository into the Minder Server |
+| `minder update` | Update CLI or server in place |
 | `minder check-update` | Check for available CLI and server updates |
-| `minder self-update` | Update CLI or server in place |
+| `minder version` | Show version information |
 
 ## MCP Tools (once connected)
 
-Your AI agents will have access to:
-
 | Tool | Description |
 |------|-------------|
 | `minder_query` | Full RAG pipeline: retrieve → reason → verify → respond |
 | `minder_search_code` | Semantic code search across indexed repositories |
-| `minder_memory_recall` | Retrieve persisted engineering memory |
-| `minder_workflow_get` | Read current workflow state |
-| `minder_session_restore` | Restore session continuity across context windows |
+| `minder_search_errors` | Look up past error patterns |
+| `minder_find_impact` | Find what a change might affect |
+| `minder_memory_store` / `minder_memory_recall` | Persistent engineering memory |
+| `minder_session_create` / `minder_session_save` / `minder_session_restore` | Cross-machine session continuity |
+| `minder_workflow_get` / `minder_workflow_guard` | Workflow governance |
 
 ## Links
 
 - [GitHub Repository](https://github.com/hiimtrung/minder)
-- [Server Setup Guide](https://github.com/hiimtrung/minder/blob/main/docs/minder-server.md)
-- [Local Dev Setup](https://github.com/hiimtrung/minder/blob/main/docs/guides/local-setup.md)
-- [System Design](https://github.com/hiimtrung/minder/blob/main/docs/system-design.md)
+- [Server Setup Guide](https://github.com/hiimtrung/minder/blob/main/docs/guides/local-setup.md)
+- [Admin & Client Onboarding](https://github.com/hiimtrung/minder/blob/main/docs/guides/admin-client-onboarding.md)
+- [System Design](https://github.com/hiimtrung/minder/blob/main/docs/architecture/system-design.md)
 
 ## License
 

minder_cli-0.6.0/README.md

@@ -0,0 +1,127 @@
+# Minder
+
+[![PyPI version](https://img.shields.io/pypi/v/minder-cli.svg)](https://pypi.org/project/minder-cli/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+**Minder** is a self-hosted MCP (Model Context Protocol) platform for repository-aware engineering intelligence.
+
+It combines an LLM inference stack, a persistent memory and workflow engine, a browser admin console, and a lightweight CLI into a single deployable unit.
+
+## What's in this repo
+
+| Component                             | Description                                                                                           |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| **Minder Server**                     | MCP gateway — SSE + streamable HTTP + stdio, RAG pipeline, workflow engine, memory, admin HTTP        |
+| **Minder Dashboard**                  | Astro admin console — client management, onboarding snippets, agent instructions, skill catalog, chat |
+| **Minder CLI** (`minder-cli` on PyPI) | Edge CLI — repo sync, MCP config install, login, self-update                                          |
+
+## Architecture
+
+```
+Developer workstation
+  ├── minder-cli          repo sync, MCP config
+  └── AI agent (IDE)  ──► Minder Server :8800
+                              │
+                    ┌──────────────┼──────────────────────┐
+                    │              │                      │
+                 Qdrant   SQLite / PostgreSQL    llama-cpp-python
+          (default vector +   (optional relational/   (LLM + embedding,
+           operational data)    graph adapters)        GGUF on host)
+```
+
+- **Transport**: SSE (`/sse`), streamable HTTP (`/mcp`), stdio
+- **LLM inference**: llama-cpp-python with GGUF models auto-downloaded from HuggingFace (Metal on Mac, CPU elsewhere)
+- **Vector search**: Qdrant for semantic retrieval
+- **Operational storage**: Qdrant by default, with optional SQLite/PostgreSQL adapters for relational and graph workloads
+
+## Quick Start
+
+### 1. Run the server
+
+```bash
+# Start infra (Qdrant)
+docker compose -f docker/docker-compose.local.yml up -d
+
+# Run Minder Server (GGUF models auto-download on first start)
+uv run python scripts/dev_server.py
+```
+
+Or use the one-command release installer (Docker only):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/hiimtrung/minder/main/scripts/release/install-minder-release.sh | bash
+```
+
+### 2. Open the dashboard
+
+```
+http://localhost:8800/dashboard
+```
+
+First run → `/dashboard/setup` to create an admin and get your `mk_...` key.
+
+### 3. Create a client and connect your IDE
+
+1. Open `/dashboard/clients` → create a client → save the `mkc_...` key (shown once in a modal)
+2. Open the client detail → copy the MCP snippet for your IDE from **Copy-ready MCP snippets**
+3. Open `/dashboard/instruction` → copy the agent orchestration rules for your IDE
+
+### 4. Install the CLI and sync a repository
+
+```bash
+# Install
+uv tool install minder-cli
+
+# Log in
+minder login --client-key mkc_your_key --server-url http://localhost:8800/sse
+
+# Write MCP config to your IDE (optional — dashboard shows it too)
+minder install --target vscode --target claude-code
+
+# Sync a repository
+minder sync
+```
+
+## 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_search_errors`                                                     | Look up past error patterns                             |
+| `minder_find_impact`                                                       | Find what a change might affect                         |
+| `minder_memory_store` / `minder_memory_recall`                             | Persistent engineering memory                           |
+| `minder_session_create` / `minder_session_save` / `minder_session_restore` | Cross-machine session continuity                        |
+| `minder_workflow_get` / `minder_workflow_step` / `minder_workflow_guard`   | Workflow governance                                     |
+| `minder_skill_store` / `minder_skill_recall`                               | Reusable pattern catalog                                |
+| `minder_agent_list` / `minder_agent_get`                                   | SubAgent registry                                       |
+
+## Dashboard Pages
+
+| Route                      | Description                                                                      |
+| -------------------------- | -------------------------------------------------------------------------------- |
+| `/dashboard`               | Home — stats and quick nav                                                       |
+| `/dashboard/clients`       | Create clients, copy MCP snippets                                                |
+| `/dashboard/instruction`   | Agent orchestration rules — copy for Claude Code, Cursor, VS Code, Codex |
+| `/dashboard/sessions`      | LLM session management                                                           |
+| `/dashboard/memories`      | Persistent memory browser                                                        |
+| `/dashboard/skills`        | Skill / pattern catalog                                                          |
+| `/dashboard/agents`        | SubAgent registry                                                                |
+| `/dashboard/chat`          | Browser-based runtime chat                                                       |
+| `/dashboard/repositories`  | Repo graph explorer                                                              |
+| `/dashboard/workflows`     | Workflow definitions                                                             |
+| `/dashboard/observability` | Audit and trace                                                                  |
+
+## Documentation
+
+- [System Design](docs/architecture/system-design.md)
+- [Local Dev Setup](docs/guides/local-setup.md)
+- [Production Deployment](docs/guides/production-deployment.md)
+- [Admin & Client Onboarding](docs/guides/admin-client-onboarding.md)
+- [Minder CLI](docs/guides/minder-cli.md)
+
+## License
+
+Apache License 2.0. See [LICENSE](LICENSE) for details.

{minder_cli-0.5.8 → minder_cli-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "minder-cli"
-version = "0.5.8"
+version = "0.6.0"
 description = "Minder CLI is the command-line interface for the Minder self-hosted MCP platform."
 readme = "README.md"
 requires-python = ">=3.14"