Metadata-Version: 2.4
Name: dendron-mesh
Version: 1.0.0
Summary: Hierarchical Git-Native Knowledge Base & Agent Memory (Zero-Dependency CLI & Stdio MCP Server)
Author-email: THE HIVE // BSO <diamantenschmiede@proton.me>
Maintainer: tastenkasperle
License: MIT
Project-URL: Homepage, https://github.com/tastenkasperle/dendron_mesh
Project-URL: Bug Tracker, https://github.com/tastenkasperle/dendron_mesh/issues
Project-URL: Repository, https://github.com/tastenkasperle/dendron_mesh.git
Keywords: mcp,mcp-server,dendron,knowledge-base,agent-memory,wikilinks,markdown,zero-dependency
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Dendron Mesh

> **Hierarchical Git-Native Knowledge Base & Agent Memory (CLI & Stdio MCP Server)**

`dendron-mesh` liberates the hierarchical dot-notation knowledge paradigm of [Dendron](https://github.com/dendronhq/dendron) from VS Code extension lock-in into a **zero-dependency, standalone Python engine** built for both humans and autonomous AI agents.

## ✨ Key Features

- **Dot-Notation Hierarchy:** Organize notes cleanly as flat Markdown files (`root.md`, `cloud.aws.iam.md`, `agents.memory.decisions.md`) that form a dynamic knowledge tree.
- **Native Wiki-Links & Backlink Graph:** Automatic extraction of `[[target.note]]` links and bidirectional backlink indexing.
- **Full-Text Search:** Fast local search across all notes in your vault.
- **Zero-Dependency:** Pure Python 3.9+ standard library. No Node.js, no VS Code, no external database required.
- **Dual Interface:** Use it directly as a **Standalone CLI** (`dendron-mesh`) or as a **Stdio MCP Server** (`dendron-mcp`) for Claude Desktop, Cursor, Antigravity, LangGraph, and CrewAI.

## 🚀 Installation

```bash
pip install dendron-mesh
```

Or run directly from source:

```bash
git clone https://github.com/tastenkasperle/dendron_mesh.git
cd dendron_mesh
pip install -e .
```

## 🛠️ CLI Usage

```bash
# Create a hierarchical note
dendron-mesh create cloud.aws.iam --title "AWS IAM Best Practices" --body "Use least-privilege roles. See [[security.zero-trust]]."

# Read a note
dendron-mesh read cloud.aws.iam

# Visualize the knowledge tree
dendron-mesh tree

# Inspect backlinks for a note
dendron-mesh backlinks security.zero-trust

# Search across the vault
dendron-mesh search "least-privilege"
```

## 🤖 MCP Server Integration

Add `dendron-mesh` to your MCP client configuration (e.g., `claude_desktop_config.json` or `mcp_config.json`):

```json
{
  "mcpServers": {
    "dendron-mesh": {
      "command": "dendron-mcp",
      "args": []
    }
  }
}
```

### Exposed MCP Tools

- `dendron_create_note` — Create or update a hierarchical note with optional frontmatter & body
- `dendron_read_note` — Read a note's metadata and markdown content
- `dendron_get_tree` — Return the hierarchical dot-notation knowledge tree
- `dendron_get_backlinks` — List all notes referencing a target note via `[[wiki-links]]`
- `dendron_search` — Full-text search across the vault

## 🧪 Testing

```bash
python -m pytest -v
```

## 📄 License

MIT © 2026 [THE HIVE // BSO](https://github.com/tastenkasperle)
