pkm-mcp-server 1.5.3 → 1.7.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,11 @@
+{
+  "name": "obsidian-pkm-marketplace",
+  "description": "Obsidian PKM Plugin for Claude Code",
+  "plugins": [
+    {
+      "name": "obsidian-pkm",
+      "description": "Bidirectional knowledge flow between Claude Code and Obsidian — tools, skills, and hooks for PKM",
+      "source": "."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "obsidian-pkm",
+  "version": "2.0.0",
+  "description": "Bidirectional knowledge flow between Claude Code and Obsidian — tools, skills, and hooks for PKM",
+  "author": {
+    "name": "Adrian Verhoosel"
+  },
+  "repository": "https://github.com/AdrianV101/obsidian-pkm-plugin",
+  "license": "MIT",
+  "keywords": ["obsidian", "pkm", "knowledge-management", "mcp", "claude-code"],
+  "mcpServers": "./.mcp.json",
+  "hooks": "./hooks/hooks.json",
+  "commands": ["./commands"],
+  "skills": ["./skills"]
+}

package/.mcp.json

@@ -0,0 +1,10 @@
+{
+  "obsidian-pkm": {
+    "command": "node",
+    "args": ["${CLAUDE_PLUGIN_ROOT}/cli.js"],
+    "env": {
+      "VAULT_PATH": "${VAULT_PATH}",
+      "OPENAI_API_KEY": "${OPENAI_API_KEY}"
+    }
+  }
+}

package/CHANGELOG.md

@@ -6,6 +6,54 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.0.0] - 2026-03-24
+
+### Breaking Changes
+- **Package renamed**: `pkm-mcp-server` → `obsidian-pkm`
+- **CLI binary renamed**: `pkm-mcp-server` → `obsidian-pkm`
+- **GitHub repo renamed**: `Obsidian-MCP` → `obsidian-pkm-plugin`
+
+### Added
+- Claude Code plugin structure (`.claude-plugin/plugin.json`)
+- Declarative hook registration (`hooks/hooks.json`) — no more manual hook copying
+- `/obsidian-pkm:setup` slash command for guided configuration
+- Self-hosted marketplace for `claude plugin install` support
+- `.mcp.json` for plugin-managed MCP server
+
+### Changed
+- Version jump from 1.6.x to 2.0.0 reflects the structural migration to a full plugin
+- Init wizard simplified for npm fallback path
+
+## [1.6.0] - 2026-03-23
+
+### Security
+- **Fix command injection in capture-handler.sh** — replaced `eval` of Node.js output with safe per-variable stdout capture. Previously, crafted `title` or `content` values containing shell metacharacters (e.g., `$(...)`) could execute arbitrary commands.
+- `handleTrash` and `handleMove` now catch ENOENT errors and return relative paths instead of leaking absolute vault paths in error messages
+
+### Changed
+- Wikilink extraction in `handleLinks` and `handleSuggestLinks` now uses shared `extractWikilinks` from `graph.js` instead of duplicating the regex
+- Extracted `addToBasenameMap`/`removeFromBasenameMap` helpers in `handlers.js` (replaces 3 inline copies)
+- Named constant `SESSION_ID_DISPLAY_LEN` replaces magic number `8` for session ID truncation
+- `@modelcontextprotocol/sdk` version range tightened from `^1.0.0` to `^1.27.0` to reflect actual minimum tested version
+
+### Fixed
+- README hook configuration referenced deleted `stop-sweep.sh` (renamed to `stop-sweep.js` in v1.5.0)
+- `vault_peek` tool description no longer claims "line numbers" in heading outline (removed in v1.1.0)
+- CHANGELOG: added missing entries for v1.5.3, v1.5.2, v1.1.1; fixed all comparison links
+- CLAUDE.md and sample-project/CLAUDE.md: added missing `note.md` template to template lists
+- CONTRIBUTING.md: clarified that double quotes and semicolons are conventions, not lint-enforced
+- CI workflow: added `permissions: {}` for least privilege; added `npm audit --omit=dev` step
+
+## [1.5.3] - 2026-03-21
+
+### Fixed
+- Init wizard `patchMcpConfig()` now handles multi-line `MCP_CONFIG=` blocks correctly — previously only replaced the first line, leaving orphaned continuation lines
+
+## [1.5.2] - 2026-03-21
+
+### Fixed
+- Hook scripts now auto-detect repo vs installed location — `capture-handler.sh` no longer hardcodes `node $SCRIPT_DIR/../index.js`, falling back to `npx pkm-mcp-server@latest` when `index.js` is not present
+
 ## [1.5.1] - 2026-03-21
 
 ### Fixed
@@ -109,6 +157,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ### Security
 - Resolved 7 transitive dependency vulnerabilities (hono, @hono/node-server, ajv, express-rate-limit, flatted, minimatch, qs)
 
+## [1.1.1] - 2026-02-24
+
+### Added
+- Enum validation for task `status` and `priority` fields in `vault_write` and `vault_update_frontmatter`
+
 ## [1.1.0] - 2026-02-23
 
 ### Changed
@@ -158,8 +211,22 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Atomic file creation in `vault_write` (`wx` flag) prevents race conditions
 - Error messages sanitized to prevent leaking absolute vault paths
 
-[Unreleased]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.2.1...HEAD
-[1.2.1]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.2.0...v1.2.1
-[1.2.0]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.1.0...v1.2.0
-[1.1.0]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.0.0...v1.1.0
-[1.0.0]: https://github.com/AdrianV101/Obsidian-MCP/releases/tag/v1.0.0
+[Unreleased]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v2.0.0...HEAD
+[2.0.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.6.0...v2.0.0
+[1.6.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.5.3...v1.6.0
+[1.5.3]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.5.2...v1.5.3
+[1.5.2]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.5.1...v1.5.2
+[1.5.1]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.5.0...v1.5.1
+[1.5.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.4.2...v1.5.0
+[1.4.2]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.4.1...v1.4.2
+[1.4.1]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.4.0...v1.4.1
+[1.4.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.3.3...v1.4.0
+[1.3.3]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.3.2...v1.3.3
+[1.3.2]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.3.1...v1.3.2
+[1.3.1]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.3.0...v1.3.1
+[1.3.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.2.1...v1.3.0
+[1.2.1]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.2.0...v1.2.1
+[1.2.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.1.1...v1.2.0
+[1.1.1]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.1.0...v1.1.1
+[1.1.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/AdrianV101/obsidian-pkm-plugin/releases/tag/v1.0.0

package/README.md

@@ -1,75 +1,76 @@
-# Obsidian PKM MCP Server
+# Obsidian PKM Plugin
 
-[![npm version](https://img.shields.io/npm/v/pkm-mcp-server)](https://www.npmjs.com/package/pkm-mcp-server)
+[![npm version](https://img.shields.io/npm/v/obsidian-pkm)](https://www.npmjs.com/package/obsidian-pkm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js >= 20](https://img.shields.io/badge/Node.js-%3E%3D20-green.svg)](https://nodejs.org/)
-[![CI](https://github.com/AdrianV101/Obsidian-MCP/actions/workflows/ci.yml/badge.svg)](https://github.com/AdrianV101/Obsidian-MCP/actions/workflows/ci.yml)
+[![CI](https://github.com/AdrianV101/obsidian-pkm-plugin/actions/workflows/ci.yml/badge.svg)](https://github.com/AdrianV101/obsidian-pkm-plugin/actions/workflows/ci.yml)
 
-An MCP (Model Context Protocol) server that gives Claude Code full read/write access to your Obsidian vault. 19 tools for note CRUD, full-text search, semantic search, graph traversal, metadata queries, session activity tracking, and passive knowledge capture. Published on npm as [`pkm-mcp-server`](https://www.npmjs.com/package/pkm-mcp-server).
+A Claude Code plugin that turns your Obsidian vault into persistent, structured memory for AI coding assistants. Provides 19 MCP tools for note creation, semantic search, graph traversal, metadata queries, session memory, and passive knowledge capture — plus hooks and skills for seamless workflow integration. Published on npm as [`obsidian-pkm`](https://www.npmjs.com/package/obsidian-pkm).
 
 ## Why
 
-Claude Code is powerful for writing code, but it forgets everything between sessions. This server turns your Obsidian vault into persistent, structured memory that Claude can read and write natively.
+Claude Code has built-in memory, but it's flat text files scoped to individual projects — no structure, no search beyond exact matches, no connections between notes, and no way to query across projects. As knowledge grows, it doesn't scale. This server replaces that with a proper PKM layer: structured notes with enforced metadata, semantic search, a navigable knowledge graph, and cross-project access through a single Obsidian vault.
 
-- **Session continuity** - Claude logs what it did and can pick up where it left off
-- **Structured knowledge** - ADRs, research notes, devlogs created from enforced templates, not freeform text dumps
-- **Semantic recall** - "find my notes about caching strategies" works even if you never used the word "caching"
-- **Graph context** - Claude can explore related notes by following wikilinks, not just keyword matches
+- **Structured session memory** — Every tool call is logged with timestamps and session IDs, so Claude can recall exactly what was read, written, and searched in previous conversations — not just what was saved to a text file.
+- **Structured knowledge creation** — ADRs, research notes, devlogs, and tasks are created from enforced templates with validated frontmatter — not freeform text dumps. Your vault stays consistent and queryable.
+- **Semantic discovery** — "Find my notes about caching strategies" works even if you never used the word "caching." Conceptual search surfaces relevant knowledge that keyword search misses.
+- **Graph-aware connections** — Claude explores your knowledge graph by following wikilinks, discovering related notes by proximity rather than just content. Link suggestions help weave new notes into your existing web of knowledge.
+- **Passive capture** — Decisions, tasks, and research findings are captured in the background without interrupting your coding flow. A session-end sweep catches anything that slipped through.
 
-Without this, every Claude Code session starts from scratch. With it, your AI assistant has a working memory that compounds over time.
+Without this, knowledge stays fragmented across per-project memory files and chat logs. With it, your AI assistant maintains a unified knowledge base that compounds over time.
 
 https://github.com/user-attachments/assets/58ad9c9b-d987-4728-89e7-33de20b73a38
 
 ## Features
 
+### Knowledge Creation & Editing
+
 | Tool | Description |
 |------|-------------|
-| `vault_read` | Read note contents (pagination by heading, tail, chunk, line range; auto-redirects large files to peek data) |
-| `vault_peek` | Inspect file metadata and structure without reading full content |
-| `vault_write` | Create notes from templates (enforces frontmatter) |
-| `vault_append` | Append to notes, with positional insert (after/before heading, end of section) |
-| `vault_edit` | Surgical string replacement |
-| `vault_search` | Full-text search across markdown files |
-| `vault_semantic_search` | Semantic similarity search via OpenAI embeddings |
-| `vault_suggest_links` | Suggest relevant notes to link based on content similarity |
-| `vault_list` | List files and folders |
-| `vault_recent` | Recently modified files |
-| `vault_links` | Wikilink analysis (incoming/outgoing) |
-| `vault_neighborhood` | Graph exploration via BFS wikilink traversal |
-| `vault_query` | Query notes by YAML frontmatter (type, status, tags/tags_any, dates, custom fields, sorting) |
-| `vault_tags` | Discover tags with counts; folder scoping, glob filters, inline tag parsing |
-| `vault_activity` | Session activity log for cross-conversation memory |
-| `vault_trash` | Soft-delete to `.trash/` (Obsidian convention), warns about broken incoming links |
-| `vault_move` | Move/rename files with automatic wikilink updating across vault |
-| `vault_update_frontmatter` | Atomic YAML frontmatter updates (set, create, remove fields; validates enum fields by note type) |
-| `vault_capture` | Signal a PKM-worthy capture (decision, task, research, bug); returns immediately, background hook creates the note |
+| `vault_write` | Create notes from templates with enforced frontmatter (ADRs, research, devlogs, tasks, etc.) |
+| `vault_append` | Add content to notes, with positional insert (after/before heading, end of section) |
+| `vault_edit` | Surgical string replacement for precise edits |
+| `vault_update_frontmatter` | Atomic YAML frontmatter updates (set, create, remove fields; validates enums by note type) |
+| `vault_capture` | Signal a PKM-worthy capture (decision, task, research, bug); background hook creates the note |
 
-### Fuzzy Path Resolution
+### Discovery & Search
 
-Read-only tools accept short names that resolve to full vault paths:
+| Tool | Description |
+|------|-------------|
+| `vault_search` | Full-text keyword search across markdown files |
+| `vault_semantic_search` | Conceptual similarity search via OpenAI embeddings — finds related notes even with different wording |
+| `vault_query` | Query by YAML frontmatter (type, status, tags, dates, custom fields) with sorting |
+| `vault_tags` | Discover all tags with per-note counts; folder scoping, glob filters, inline tag parsing |
+| `vault_suggest_links` | Suggest relevant notes to link based on content similarity |
 
-```javascript
-vault_read({ path: "devlog" })
-// Resolves to: 01-Projects/Obsidian-MCP/development/devlog.md
+### Graph & Connections
 
-vault_read({ path: "devlog.md" })
-// Same result — .md extension is optional
+| Tool | Description |
+|------|-------------|
+| `vault_links` | Wikilink analysis (incoming and outgoing links for a note) |
+| `vault_neighborhood` | Graph exploration via BFS wikilink traversal — discover related notes by proximity |
 
-vault_links({ path: "alpha" })
-// Works on vault_peek, vault_links, vault_neighborhood, vault_suggest_links too
-```
+### Reading & Navigation
 
-Folder-scoped tools accept partial folder names:
+| Tool | Description |
+|------|-------------|
+| `vault_read` | Read note contents (pagination by heading, tail, chunk, line range; auto-redirects large files) |
+| `vault_peek` | Inspect file metadata and structure without reading full content |
+| `vault_list` | List files and folders |
+| `vault_recent` | Recently modified files |
 
-```javascript
-vault_search({ query: "API design", folder: "Obsidian-MCP" })
-// Resolves folder to: 01-Projects/Obsidian-MCP
+### Organization & Maintenance
 
-vault_tags({ folder: "Obsidian-MCP" })
-// Works on vault_search, vault_query, vault_tags, vault_recent
-```
+| Tool | Description |
+|------|-------------|
+| `vault_move` | Move/rename files with automatic wikilink updating across the vault |
+| `vault_trash` | Soft-delete to `.trash/` (Obsidian convention), warns about broken incoming links |
 
-Ambiguous matches return an error listing candidates. Exact paths always work unchanged.
+### Session Memory
+
+| Tool | Description |
+|------|-------------|
+| `vault_activity` | Cross-conversation memory — logs every tool call with timestamps and session IDs |
 
 ## Prerequisites
 
@@ -84,14 +85,32 @@ Ambiguous matches return an error listing candidates. Exact paths always work un
 
 ### 1. Install and Set Up
 
-**From npm** (recommended):
+**Via Claude Code plugin marketplace** (recommended):
+
+```bash
+claude plugin marketplace add AdrianV101/obsidian-pkm-plugin
+claude plugin install obsidian-pkm
+```
+
+Then run the setup skill in Claude Code:
+
+```
+/obsidian-pkm:setup
+```
+
+The setup skill walks you through vault path, templates, folder structure, semantic search, and Claude Code registration.
+
+**Via npm** (fallback):
 
 ```bash
-npm install -g pkm-mcp-server
-pkm-mcp-server init
+npm install -g obsidian-pkm
+obsidian-pkm init
 ```
 
-The setup wizard walks you through 5 steps. Nothing is written until you confirm each step, and you can press Ctrl+C at any time to cancel.
+The setup wizard walks you through vault path, templates, folder structure, semantic search, and Claude Code registration. Nothing is written until you confirm each step, and you can press Ctrl+C at any time to cancel.
+
+<details>
+<summary>Wizard step details</summary>
 
 **Step 1 — Vault path.** Point to an existing Obsidian vault or create a new one. The wizard resolves `~`, `$HOME`, and relative paths automatically. Safety checks prevent using system directories (`/`, `/home`, etc.) as a vault. For existing non-empty directories you can use it as-is, create a subfolder inside it, or wipe it (with triple confirmation). You'll be offered an optional backup before any changes — this creates a timestamped copy next to the vault (e.g. `PKM-backup-2026-03-21T14-30-00/`).
 
@@ -116,29 +135,31 @@ Existing templates are never overwritten.
 
 Each `_index.md` has `type: moc` frontmatter. Existing folders and index files are skipped.
 
-**Step 4 — OpenAI API key (optional).** Enables `vault_semantic_search` and `vault_suggest_links`. The key is stored only in your Claude Code configuration (`~/.claude.json`) and is used solely for generating text embeddings. You can add this later — see [Enable Semantic Search](#3-enable-semantic-search-optional).
+**Step 4 — OpenAI API key (optional).** Enables `vault_semantic_search` and `vault_suggest_links`. The key is stored only in your Claude Code configuration (`~/.claude.json`) and is used solely for generating text embeddings. You can add this later — see [Enable Semantic Search](#4-enable-semantic-search-optional).
 
 **Step 5 — Claude Code registration.** Registers the MCP server via `claude mcp add -s user`. If `obsidian-pkm` is already registered, you'll be asked whether to overwrite. The exact command is shown for confirmation before running. If the `claude` CLI is not found on PATH, the wizard prints the manual registration command instead.
 
+</details>
+
 Restart Claude Code after setup. The server provides all tools except semantic search out of the box.
 
 **From source:**
 
 ```bash
-git clone https://github.com/AdrianV101/Obsidian-MCP.git
-cd Obsidian-MCP
+git clone https://github.com/AdrianV101/obsidian-pkm-plugin.git
+cd obsidian-pkm-plugin
 npm install
 node cli.js init
 ```
 
-You can also run the wizard without a global install: `npx pkm-mcp-server init`.
+You can also run the wizard without a global install: `npx obsidian-pkm init`.
 
 ### 2. Manual Registration (alternative)
 
 If you prefer to skip the wizard, register directly with the Claude CLI:
 
 ```bash
-claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault -- obsidian-pkm npx -y pkm-mcp-server@latest
+claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault -- obsidian-pkm npx -y obsidian-pkm@latest
 ```
 
 For a source install:
@@ -149,7 +170,15 @@ claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault -- obsidian-pk
 
 Verify with `claude mcp list` — you should see `obsidian-pkm: ... - Connected`.
 
-### 3. Enable Semantic Search (optional)
+### 3. Verify It Works
+
+Open Claude Code and try:
+
+> List the folders in my vault
+
+Claude should call `vault_list` and show your vault's directory structure. If it works, the server is connected and ready.
+
+### 4. Enable Semantic Search (optional)
 
 If you didn't set this up during `init`, add your OpenAI API key by re-registering:
 
@@ -158,12 +187,12 @@ claude mcp remove obsidian-pkm
 claude mcp add -s user \
   -e VAULT_PATH=/absolute/path/to/your/vault \
   -e OPENAI_API_KEY=sk-... \
-  -- obsidian-pkm npx -y pkm-mcp-server@latest
+  -- obsidian-pkm npx -y obsidian-pkm@latest
 ```
 
 This enables `vault_semantic_search` and `vault_suggest_links`. Uses `text-embedding-3-large` with a SQLite + sqlite-vec index stored at `.obsidian/semantic-index.db`. The index rebuilds automatically — delete the DB file to force a full re-embed.
 
-### 4. Enable PKM Hooks (optional)
+### 5. Enable PKM Hooks (optional)
 
 The hook system adds automatic context loading at session start and passive knowledge capture during coding. Requires the [Claude CLI](https://docs.anthropic.com/en/docs/claude-cli) installed and authenticated.
 
@@ -178,7 +207,7 @@ Add to your `~/.claude/settings.json` (alongside the `mcpServers` block):
         "hooks": [
           {
             "type": "command",
-            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/Obsidian-MCP/hooks/session-start.js",
+            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/obsidian-pkm-plugin/hooks/session-start.js",
             "timeout": 15,
             "statusMessage": "Loading PKM project context..."
           }
@@ -190,7 +219,7 @@ Add to your `~/.claude/settings.json` (alongside the `mcpServers` block):
         "hooks": [
           {
             "type": "command",
-            "command": "VAULT_PATH=\"/path/to/your/vault\" /path/to/Obsidian-MCP/hooks/stop-sweep.sh",
+            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/obsidian-pkm-plugin/hooks/stop-sweep.js",
             "async": true,
             "timeout": 10
           }
@@ -203,7 +232,7 @@ Add to your `~/.claude/settings.json` (alongside the `mcpServers` block):
         "hooks": [
           {
             "type": "command",
-            "command": "VAULT_PATH=\"/path/to/your/vault\" /path/to/Obsidian-MCP/hooks/capture-handler.sh",
+            "command": "VAULT_PATH=\"/path/to/your/vault\" /path/to/obsidian-pkm-plugin/hooks/capture-handler.sh",
             "async": true,
             "timeout": 10
           }
@@ -214,12 +243,12 @@ Add to your `~/.claude/settings.json` (alongside the `mcpServers` block):
 }
 ```
 
-Replace `/path/to/your/vault` with your Obsidian vault path and `/path/to/Obsidian-MCP` with the path to this repo (or the global npm install location).
+Replace `/path/to/your/vault` with your Obsidian vault path and `/path/to/obsidian-pkm-plugin` with the path to this repo (or the global npm install location).
 
 | Hook | Event | What it does |
 |------|-------|--------------|
 | `session-start.js` | SessionStart | Loads project context (index, devlog, active tasks) at session start |
-| `stop-sweep.sh` | Stop | Scans each exchange for PKM-worthy decisions/tasks, appends to daily captures |
+| `stop-sweep.js` | Stop | PKM librarian: creates structured, graph-linked vault notes from the latest exchange |
 | `capture-handler.sh` | PostToolUse | Creates structured vault notes when `vault_capture` is called |
 
 See [hooks/README.md](hooks/README.md) for architecture details and troubleshooting.
@@ -246,7 +275,7 @@ Vault/
 
 ### Templates
 
-`vault_write` loads all `.md` files from `05-Templates/` at startup and enforces frontmatter on every note created. The setup wizard (`pkm-mcp-server init`) installs these automatically — or you can copy the files from `templates/` manually.
+`vault_write` loads all `.md` files from `05-Templates/` at startup and enforces frontmatter on every note created. The setup wizard (`obsidian-pkm init`) installs these automatically — or you can copy the files from `templates/` manually.
 
 13 included templates: `adr`, `daily-note`, `devlog`, `fleeting-note`, `literature-note`, `meeting-notes`, `moc`, `note`, `permanent-note`, `project-index`, `research-note`, `task`, `troubleshooting-log`. Add your own templates to `05-Templates/` and they become available to `vault_write` automatically.
 
@@ -288,15 +317,17 @@ All paths passed to tools are relative to vault root. The server includes path s
 
 ## How It Works
 
-**Note creation** is template-based. `vault_write` loads templates from `05-Templates/`, substitutes Templater-compatible variables (`<% tp.date.now("YYYY-MM-DD") %>`, `<% tp.file.title %>`), and validates required frontmatter fields (`type`, `created`, `tags`). Optional frontmatter fields — `status`, `priority`, `project`, `deciders`, `due`, `source` — can be set per template type. Task notes enforce enum validation on `status` (pending/active/done/cancelled) and `priority` (low/normal/high/urgent).
+**Knowledge creation** is template-based. `vault_write` loads templates from `05-Templates/`, substitutes Templater-compatible variables (`<% tp.date.now("YYYY-MM-DD") %>`, `<% tp.file.title %>`), and validates required frontmatter fields (`type`, `created`, `tags`). This ensures every note in your vault has consistent metadata — making it queryable, sortable, and discoverable from day one. Task notes enforce enum validation on `status` and `priority`; other types accept `project`, `deciders`, `due`, and `source`.
+
+**Knowledge discovery** works at two levels. Keyword search (`vault_search`) finds exact terms. Semantic search embeds notes using OpenAI and finds conceptually related content — so "managing overwhelm" surfaces notes about "cognitive load" even if those exact words never appear together. The semantic index watches for file changes in real-time and syncs across machines via Obsidian Sync.
 
-**Semantic search** embeds notes on startup and watches for changes via `fs.watch`. Long notes are chunked by `##` headings. The index is a regenerable cache stored in `.obsidian/` so it syncs across machines via Obsidian Sync. The initial sync runs in the background — search is available immediately but may return incomplete results until sync finishes (a progress message is shown).
+**Knowledge connections** are maintained through Obsidian's `[[wikilink]]` graph. `vault_neighborhood` traverses links via BFS to discover related notes by proximity, while `vault_suggest_links` recommends connections you haven't made yet. `vault_move` rewrites wikilinks across the vault when you reorganize, and `vault_trash` warns about links that would break.
 
-**Graph exploration** resolves `[[wikilinks]]` to file paths (handling aliases, headings, and ambiguous basenames), then does BFS traversal to return notes grouped by hop distance.
+**Session memory** records every tool call with timestamps and session IDs, so Claude can recall what was read, written, or searched in previous conversations. This turns ephemeral chat sessions into a continuous thread of work.
 
-**Activity logging** records every tool call (except `vault_activity` itself) with timestamps and session IDs, enabling Claude to recall what happened in previous conversations.
+**Passive capture** uses `vault_capture` to signal that something is worth persisting (a decision, task, research finding, or bug). The tool returns immediately — a PostToolUse hook spawns a background agent that creates the structured vault note. Combined with the Stop hook (which sweeps each session for un-captured knowledge), this keeps your vault up to date without interrupting the coding flow.
 
-**Passive capture** uses `vault_capture` to signal that something is worth persisting (a decision, task, research finding, or bug). The tool returns immediately — a PostToolUse hook spawns a background agent that creates the structured vault note. Combined with the Stop hook (which sweeps each session for un-captured decisions and tasks), this keeps the vault up to date without interrupting the coding flow.
+**Fuzzy path resolution** lets read-only tools accept short names instead of full vault paths. `vault_read({ path: "devlog" })` resolves to `01-Projects/MyApp/development/devlog.md` automatically (`.md` extension optional). Folder-scoped tools like `vault_search` and `vault_query` accept partial folder names — `folder: "MyApp"` resolves to `01-Projects/MyApp`. Ambiguous matches return an error listing candidates. Write/destructive tools always require exact paths.
 
 ## Troubleshooting
 
@@ -304,13 +335,13 @@ All paths passed to tools are relative to vault root. The server includes path s
 You need C++ build tools. See [Prerequisites](#prerequisites) for your platform. On Linux, `sudo apt install build-essential python3` usually fixes it.
 
 **Server starts but all tool calls fail with ENOENT**
-Your `VAULT_PATH` is wrong or missing. The server validates this at startup and exits with a clear error. Re-register with the correct path: `claude mcp remove obsidian-pkm && claude mcp add -s user -e VAULT_PATH=/correct/path -- obsidian-pkm npx -y pkm-mcp-server@latest`
+Your `VAULT_PATH` is wrong or missing. The server validates this at startup and exits with a clear error. Re-register with the correct path: `claude mcp remove obsidian-pkm && claude mcp add -s user -e VAULT_PATH=/correct/path -- obsidian-pkm npx -y obsidian-pkm@latest`
 
 **`vault_write` says "no templates available"**
-Run `pkm-mcp-server init` to install templates, or copy the `templates/` files from this repo into your vault's `05-Templates/` directory. The server loads templates from there at startup.
+Run `obsidian-pkm init` to install templates, or copy the `templates/` files from this repo into your vault's `05-Templates/` directory. The server loads templates from there at startup.
 
 **Semantic search not appearing in tool list**
-Set `OPENAI_API_KEY` in your MCP server registration. See [Enable Semantic Search](#3-enable-semantic-search-optional). Without it, `vault_semantic_search` and `vault_suggest_links` are hidden entirely.
+Set `OPENAI_API_KEY` in your MCP server registration. See [Enable Semantic Search](#4-enable-semantic-search-optional). Without it, `vault_semantic_search` and `vault_suggest_links` are hidden entirely.
 
 **Server not showing up in Claude Code after install**
 Run `claude mcp list` to check. If `obsidian-pkm` is missing, register it with `claude mcp add` (see [Manual Registration](#2-manual-registration-alternative)). Note: editing `~/.claude/settings.json` directly does **not** register MCP servers — use the CLI.

package/cli.js

@@ -2,6 +2,14 @@
 
 import { createRequire } from "module";
 
+console.warn("");
+console.warn("  pkm-mcp-server has been renamed to obsidian-pkm.");
+console.warn("  Install the new version:");
+console.warn("    Marketplace: claude plugin marketplace add AdrianV101/obsidian-pkm-plugin");
+console.warn("    npm:         npm install -g obsidian-pkm");
+console.warn("  Then uninstall the old package: npm uninstall -g pkm-mcp-server");
+console.warn("");
+
 const subcommand = process.argv[2];
 
 try {
@@ -11,13 +19,13 @@ try {
   } else if (subcommand === "--version" || subcommand === "-v") {
     const require = createRequire(import.meta.url);
     const { version } = require("./package.json");
-    console.log(`pkm-mcp-server v${version}`);
+    console.log(`obsidian-pkm v${version}`);
   } else if (!subcommand) {
     const { startServer } = await import("./index.js");
     await startServer();
   } else {
     console.error(`Unknown command: ${subcommand}`);
-    console.error("Usage: pkm-mcp-server [init]");
+    console.error("Usage: obsidian-pkm [init]");
     process.exit(1);
   }
 } catch (e) {

package/commands/setup.md

@@ -0,0 +1,50 @@
+---
+name: setup
+description: Configure Obsidian PKM plugin — set vault path, API keys, and verify setup
+allowed-tools: [Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion]
+---
+
+# Obsidian PKM Setup
+
+You are configuring the Obsidian PKM plugin. Walk the user through these steps:
+
+## Step 1: Vault Path
+
+Ask the user for their Obsidian vault path. Validate that:
+- The path exists and is a directory
+- It contains at least one `.md` file
+- Suggest `~/Documents/PKM` as a default
+
+If the path is valid, instruct the user to add `export VAULT_PATH="/absolute/path/to/vault"` to their shell profile (`~/.zshrc` or `~/.bashrc`) if not already set. Verify with `echo $VAULT_PATH`.
+
+## Step 2: OpenAI API Key (Optional)
+
+Ask if they want semantic search features (vault_semantic_search, vault_suggest_links). If yes:
+- Ask for their OpenAI API key
+- Instruct them to add `export OPENAI_API_KEY="sk-..."` to their shell profile
+- Explain this enables 2 additional tools but is completely optional
+
+## Step 3: Verify Setup
+
+Run these checks:
+1. `echo $VAULT_PATH` — confirm it's set
+2. Count `.md` files in the vault: `find "$VAULT_PATH" -name "*.md" | wc -l`
+3. Check if templates exist: `ls "$VAULT_PATH/05-Templates/"` — if missing, offer to run `obsidian-pkm init` to scaffold the vault structure
+
+## Step 4: Migration Check
+
+Check if the old `pkm-mcp-server` is installed:
+1. Run `npm list -g pkm-mcp-server --depth=0 2>/dev/null`
+2. Check for stale hooks: `ls ~/.claude/hooks/pkm/ 2>/dev/null`
+
+If found:
+- Suggest: `npm uninstall -g pkm-mcp-server`
+- Suggest removing `~/.claude/hooks/pkm/` directory (hooks are now managed by the plugin)
+- Check `~/.claude/settings.json` for old hook entries and offer to clean them up
+
+## Step 5: Done
+
+Confirm setup is complete. Tell the user:
+- "Your Obsidian PKM plugin is configured. Try asking me to list your vault folders to verify."
+- If OPENAI_API_KEY was set: "Semantic search will build its index in the background on first use."
+- **Important**: "If you just added environment variables to your shell profile, you'll need to restart your Claude Code session (or run `source ~/.zshrc`) for the MCP server and hooks to pick them up."

package/handlers.js

@@ -23,7 +23,7 @@ import {
   FORCE_HARD_CAP,
   CHUNK_SIZE,
 } from "./helpers.js";
-import { exploreNeighborhood, formatNeighborhood, findFilesLinkingTo, rewriteWikilinks } from "./graph.js";
+import { exploreNeighborhood, formatNeighborhood, findFilesLinkingTo, rewriteWikilinks, extractWikilinks } from "./graph.js";
 import { getAllMarkdownFiles, extractFrontmatter } from "./utils.js";
 
 /**
@@ -63,6 +63,26 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     return resolvePath(resolvedFolder);
   };
 
+  const SESSION_ID_DISPLAY_LEN = 8;
+
+  function addToBasenameMap(relativePath) {
+    const bn = path.basename(relativePath, ".md").toLowerCase();
+    if (!basenameMap.has(bn)) basenameMap.set(bn, []);
+    basenameMap.get(bn).push(relativePath);
+    allFilesSet.add(relativePath);
+  }
+
+  function removeFromBasenameMap(relativePath) {
+    allFilesSet.delete(relativePath);
+    const bn = path.basename(relativePath, ".md").toLowerCase();
+    const entries = basenameMap.get(bn);
+    if (entries) {
+      const idx = entries.indexOf(relativePath);
+      if (idx !== -1) entries.splice(idx, 1);
+      if (entries.length === 0) basenameMap.delete(bn);
+    }
+  }
+
   async function handleRead(args) {
     const filePath = resolveFile(args.path);
     const content = await fs.readFile(filePath, "utf-8");
@@ -193,12 +213,7 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     }
 
     // Update basename map with the new file
-    const newBasename = path.basename(outputPath, ".md").toLowerCase();
-    if (!basenameMap.has(newBasename)) {
-      basenameMap.set(newBasename, []);
-    }
-    basenameMap.get(newBasename).push(outputPath);
-    allFilesSet.add(outputPath);
+    addToBasenameMap(outputPath);
 
     const fm = validation.frontmatter;
     const createdStr = fm.created instanceof Date
@@ -403,11 +418,7 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     const result = { outgoing: [], incoming: [] };
 
     if (args.direction !== "incoming") {
-      const linkRegex = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
-      let match;
-      while ((match = linkRegex.exec(content)) !== null) {
-        result.outgoing.push(match[1]);
-      }
+      result.outgoing = extractWikilinks(content);
     }
 
     if (args.direction !== "outgoing") {
@@ -580,20 +591,20 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
 
       if (entries.length === 0) {
         return {
-          content: [{ type: "text", text: `No activity entries found. (current session: ${sessionId.slice(0, 8)})` }]
+          content: [{ type: "text", text: `No activity entries found. (current session: ${sessionId.slice(0, SESSION_ID_DISPLAY_LEN)})` }]
         };
       }
 
       const formatted = entries.map(e => {
         const ts = e.timestamp.replace("T", " ").slice(0, 19);
-        const sessionShort = e.session_id.slice(0, 8);
+        const sessionShort = e.session_id.slice(0, SESSION_ID_DISPLAY_LEN);
         return `[${ts}] [${sessionShort}] ${e.tool_name}\n${e.args_json}`;
       }).join("\n\n");
 
       return {
         content: [{
           type: "text",
-          text: `Activity log (${entries.length} entr${entries.length === 1 ? "y" : "ies"}, current session: ${sessionId.slice(0, 8)}):\n\n${formatted}`
+          text: `Activity log (${entries.length} entr${entries.length === 1 ? "y" : "ies"}, current session: ${sessionId.slice(0, SESSION_ID_DISPLAY_LEN)}):\n\n${formatted}`
         }]
       };
     }
@@ -651,13 +662,9 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     }
     if (!body) throw new Error("No content to analyze");
 
-    const linkRegex = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
-    const linkedNames = new Set();
-    let match;
-    while ((match = linkRegex.exec(inputText)) !== null) {
-      const target = match[1];
-      linkedNames.add(path.basename(target, ".md").toLowerCase());
-    }
+    const linkedNames = new Set(
+      extractWikilinks(inputText).map(t => path.basename(t, ".md").toLowerCase())
+    );
 
     const excludeFiles = new Set();
     if (sourcePath) excludeFiles.add(sourcePath);
@@ -696,7 +703,12 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     const filePath = resolvePath(resolvedRelative);
 
     // Verify file exists
-    await fs.access(filePath);
+    try {
+      await fs.access(filePath);
+    } catch (e) {
+      if (e.code === "ENOENT") throw new Error(`ENOENT: File not found: ${resolvedRelative}`, { cause: e });
+      throw e;
+    }
 
     // Find incoming links for warning output
     const allFilesList = Array.from(allFilesSet);
@@ -725,14 +737,7 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     await fs.rename(filePath, trashAbsolute);
 
     // Update in-memory basename map
-    allFilesSet.delete(resolvedRelative);
-    const oldBasename = path.basename(resolvedRelative, ".md").toLowerCase();
-    const entries = basenameMap.get(oldBasename);
-    if (entries) {
-      const idx = entries.indexOf(resolvedRelative);
-      if (idx !== -1) entries.splice(idx, 1);
-      if (entries.length === 0) basenameMap.delete(oldBasename);
-    }
+    removeFromBasenameMap(resolvedRelative);
 
     // Build output
     let text = `Trashed ${resolvedRelative} → ${trashRelative}`;
@@ -754,7 +759,12 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     const newAbsolute = resolvePath(newRelative);
 
     // Verify source exists
-    await fs.access(oldAbsolute);
+    try {
+      await fs.access(oldAbsolute);
+    } catch (e) {
+      if (e.code === "ENOENT") throw new Error(`ENOENT: File not found: ${oldRelative}`, { cause: e });
+      throw e;
+    }
 
     // Verify destination does NOT exist
     try {
@@ -775,23 +785,11 @@ export async function createHandlers({ vaultPath, templateRegistry, semanticInde
     await fs.rename(oldAbsolute, newAbsolute);
 
     // Update basename map: remove old, add new
-    allFilesSet.delete(oldRelative);
-    const oldBasename = path.basename(oldRelative, ".md").toLowerCase();
-    const oldEntries = basenameMap.get(oldBasename);
-    if (oldEntries) {
-      const idx = oldEntries.indexOf(oldRelative);
-      if (idx !== -1) oldEntries.splice(idx, 1);
-      if (oldEntries.length === 0) basenameMap.delete(oldBasename);
-    }
-
-    allFilesSet.add(newRelative);
-    const newBasename = path.basename(newRelative, ".md").toLowerCase();
-    if (!basenameMap.has(newBasename)) {
-      basenameMap.set(newBasename, []);
-    }
-    basenameMap.get(newBasename).push(newRelative);
+    removeFromBasenameMap(oldRelative);
+    addToBasenameMap(newRelative);
 
     // Determine new link target — use full path if basename is now ambiguous
+    const newBasename = path.basename(newRelative, ".md").toLowerCase();
     const newEntries = basenameMap.get(newBasename);
     const isAmbiguous = newEntries && newEntries.length > 1;
     const newLinkTarget = isAmbiguous

package/hooks/README.md

@@ -39,7 +39,7 @@ Add the following to your `~/.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/Obsidian-MCP/hooks/session-start.js",
+            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/obsidian-pkm-plugin/hooks/session-start.js",
             "timeout": 15,
             "statusMessage": "Loading PKM project context..."
           }
@@ -51,7 +51,7 @@ Add the following to your `~/.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/Obsidian-MCP/hooks/stop-sweep.js",
+            "command": "VAULT_PATH=\"/path/to/your/vault\" node /path/to/obsidian-pkm-plugin/hooks/stop-sweep.js",
             "async": true,
             "timeout": 10
           }
@@ -64,7 +64,7 @@ Add the following to your `~/.claude/settings.json`:
         "hooks": [
           {
             "type": "command",
-            "command": "VAULT_PATH=\"/path/to/your/vault\" /path/to/Obsidian-MCP/hooks/capture-handler.sh",
+            "command": "VAULT_PATH=\"/path/to/your/vault\" /path/to/obsidian-pkm-plugin/hooks/capture-handler.sh",
             "async": true,
             "timeout": 10
           }
@@ -75,7 +75,7 @@ Add the following to your `~/.claude/settings.json`:
 }
 ```
 
-Replace `/path/to/your/vault` with the absolute path to your Obsidian vault (e.g., `~/Documents/PKM`), and `/path/to/Obsidian-MCP` with the absolute path to this repository.
+Replace `/path/to/your/vault` with the absolute path to your Obsidian vault (e.g., `~/Documents/PKM`), and `/path/to/obsidian-pkm-plugin` with the absolute path to this repository.
 
 ## Architecture Notes
 

package/hooks/capture-handler.sh

@@ -15,19 +15,23 @@ trap cleanup EXIT
 # Read hook input from stdin
 INPUT=$(cat)
 
-# Extract tool_input fields (buffer all stdin before parsing)
-eval "$(echo "$INPUT" | node -e "
-  let b='';
-  process.stdin.on('data',c=>b+=c);
-  process.stdin.on('end',()=>{
-    const j=JSON.parse(b);
-    const ti=j.tool_input||{};
-    console.log('TOOL_INPUT='+JSON.stringify(JSON.stringify(ti)));
-    console.log('CAPTURE_TYPE='+JSON.stringify(ti.type||''));
-    console.log('CAPTURE_TITLE='+JSON.stringify(ti.title||''));
-    console.log('CAPTURE_CONTENT='+JSON.stringify(ti.content||''));
-  })
-")"
+# Extract tool_input fields safely (no eval — stdout capture only)
+TOOL_INPUT=$(echo "$INPUT" | node -e "
+  let b=''; process.stdin.on('data',c=>b+=c);
+  process.stdin.on('end',()=>{ process.stdout.write(JSON.stringify(JSON.parse(b).tool_input||{})); })
+")
+CAPTURE_TYPE=$(echo "$INPUT" | node -e "
+  let b=''; process.stdin.on('data',c=>b+=c);
+  process.stdin.on('end',()=>{ process.stdout.write((JSON.parse(b).tool_input||{}).type||''); })
+")
+CAPTURE_TITLE=$(echo "$INPUT" | node -e "
+  let b=''; process.stdin.on('data',c=>b+=c);
+  process.stdin.on('end',()=>{ process.stdout.write((JSON.parse(b).tool_input||{}).title||''); })
+")
+CAPTURE_CONTENT=$(echo "$INPUT" | node -e "
+  let b=''; process.stdin.on('data',c=>b+=c);
+  process.stdin.on('end',()=>{ process.stdout.write((JSON.parse(b).tool_input||{}).content||''); })
+")
 
 # Skip if missing required fields
 if [ -z "$CAPTURE_TYPE" ] || [ -z "$CAPTURE_TITLE" ] || [ -z "$CAPTURE_CONTENT" ]; then
@@ -46,7 +50,7 @@ MCP_CONFIG=$(node -e "
   if (process.env.OPENAI_API_KEY) env.OPENAI_API_KEY = process.env.OPENAI_API_KEY;
   const server = useLocal
     ? { command: 'node', args: [localIndex], env }
-    : { command: 'npx', args: ['-y', 'pkm-mcp-server@latest'], env };
+    : { command: 'npx', args: ['-y', 'obsidian-pkm@latest'], env };
   console.log(JSON.stringify({ mcpServers: { 'obsidian-pkm': server } }));
 " "$SCRIPT_DIR" "${VAULT_PATH:-$HOME/Documents/PKM}")
 

package/hooks/hooks.json

@@ -0,0 +1,35 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [{
+          "type": "command",
+          "command": "VAULT_PATH=${VAULT_PATH} node ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js",
+          "timeout": 15
+        }]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "mcp__obsidian-pkm__vault_capture",
+        "hooks": [{
+          "type": "command",
+          "command": "VAULT_PATH=${VAULT_PATH} bash ${CLAUDE_PLUGIN_ROOT}/hooks/capture-handler.sh",
+          "timeout": 30,
+          "async": true
+        }]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [{
+          "type": "command",
+          "command": "VAULT_PATH=${VAULT_PATH} node ${CLAUDE_PLUGIN_ROOT}/hooks/stop-sweep.js",
+          "timeout": 15,
+          "async": true
+        }]
+      }
+    ]
+  }
+}

package/hooks/stop-sweep.js

@@ -61,7 +61,11 @@ async function main() {
 
   // Resolve project — no project, no captures
   const { projectPath, error } = await resolveProject(cwd, VAULT_PATH);
-  if (error || !projectPath) return;
+  if (error) {
+    logError(`project resolution failed: ${error}`);
+    return;
+  }
+  if (!projectPath) return;
 
   // Build MCP config — auto-detect repo (../index.js exists) vs installed (use npx)
   const localIndex = join(__dirname, "..", "index.js");
@@ -74,7 +78,7 @@ async function main() {
     mcpServers: {
       "obsidian-pkm": useLocal
         ? { command: "node", args: [localIndex], env: mcpEnv }
-        : { command: "npx", args: ["-y", "pkm-mcp-server@latest"], env: mcpEnv },
+        : { command: "npx", args: ["-y", "obsidian-pkm@latest"], env: mcpEnv },
     },
   });
 

package/index.js

@@ -38,7 +38,7 @@ export async function startServer() {
 
   // Create the server
   const server = new Server(
-    { name: "pkm-mcp-server", version: PKG_VERSION },
+    { name: "obsidian-pkm", version: PKG_VERSION },
     { capabilities: { tools: {} } }
   );
 
@@ -73,7 +73,7 @@ export async function startServer() {
       },
       {
         name: "vault_peek",
-        description: "Inspect a file's metadata and structure without reading full content. Returns file size, frontmatter, heading outline with line numbers and approximate section sizes, and a brief preview. Use this to plan which sections to read from large files.",
+        description: "Inspect a file's metadata and structure without reading full content. Returns file size, frontmatter, heading outline with approximate section sizes, and a brief preview. Use this to plan which sections to read from large files.",
         inputSchema: {
           type: "object",
           properties: {

package/init.js

@@ -192,7 +192,7 @@ export async function dirSize(dirPath) {
 export function detectInstallType(filePath) {
   const thisFile = filePath || fileURLToPath(import.meta.url);
   if (thisFile.includes("node_modules")) {
-    return { command: "npx", args: ["-y", "pkm-mcp-server@latest"] };
+    return { command: "npx", args: ["-y", "obsidian-pkm@latest"] };
   }
   const cliPath = path.join(path.dirname(thisFile), "cli.js");
   return { command: "node", args: [cliPath] };
@@ -394,7 +394,7 @@ export async function runInit() {
   try {
     // ── Step 1: Welcome ──
     console.log(`
-pkm-mcp-server setup wizard
+obsidian-pkm setup wizard
 
 This will walk you through setting up your Obsidian vault for use with the
 PKM MCP server. You'll be asked about 6 things:
@@ -508,7 +508,7 @@ Nothing is written until you confirm each step. Press Ctrl+C at any time to canc
 
       let skipRegistration = false;
       if (hasExisting) {
-        const overwrite = await confirmPrompt({ message: "Claude Code is already configured for pkm-mcp-server. Overwrite?", default: false });
+        const overwrite = await confirmPrompt({ message: "Claude Code is already configured for obsidian-pkm. Overwrite?", default: false });
         if (!overwrite) {
           console.log("  Registration skipped.\n");
           skipRegistration = true;
@@ -548,7 +548,7 @@ Nothing is written until you confirm each step. Press Ctrl+C at any time to canc
             steps.push("MCP server: skipped (registration failed)");
           }
         } else {
-          console.log("  Registration: skipped (you can run `pkm-mcp-server init` again later)");
+          console.log("  Registration: skipped (you can run `obsidian-pkm init` again later)");
           steps.push("MCP server: skipped");
         }
       } else {
@@ -678,7 +678,7 @@ To verify, restart Claude Code and try:
   "List the folders in my vault"
 
 Claude should call vault_list and show your vault's directory structure.
-If that doesn't work, check: https://github.com/AdrianV101/Obsidian-MCP#troubleshooting
+If that doesn't work, check: https://github.com/AdrianV101/obsidian-pkm-plugin#troubleshooting
 `);
   } catch (e) {
     if (e.name === "ExitPromptError") {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "pkm-mcp-server",
-  "version": "1.5.3",
-  "description": "MCP server for Obsidian vault integration with Claude Code — 19 tools for notes, search, and graph traversal",
+  "version": "1.7.0",
+  "description": "Claude Code plugin for Obsidian vault integration — 19 MCP tools, hooks, and skills for PKM",
   "main": "cli.js",
   "exports": {
     ".": "./cli.js"
   },
   "bin": {
-    "pkm-mcp-server": "cli.js"
+    "obsidian-pkm": "cli.js"
   },
   "type": "module",
   "engines": {
@@ -19,7 +19,11 @@
     "CHANGELOG.md",
     "hooks/",
     "templates/",
-    "sample-project/"
+    "sample-project/",
+    ".claude-plugin/",
+    "commands/",
+    "skills/",
+    ".mcp.json"
   ],
   "scripts": {
     "start": "node cli.js",
@@ -29,7 +33,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/AdrianV101/Obsidian-MCP.git"
+    "url": "git+https://github.com/AdrianV101/obsidian-pkm-plugin.git"
   },
   "author": "Adrian Verhoosel",
   "license": "MIT",
@@ -45,15 +49,17 @@
     "markdown",
     "notes",
     "semantic-search",
-    "wikilinks"
+    "wikilinks",
+    "plugin",
+    "hooks"
   ],
-  "homepage": "https://github.com/AdrianV101/Obsidian-MCP#readme",
+  "homepage": "https://github.com/AdrianV101/obsidian-pkm-plugin#readme",
   "bugs": {
-    "url": "https://github.com/AdrianV101/Obsidian-MCP/issues"
+    "url": "https://github.com/AdrianV101/obsidian-pkm-plugin/issues"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.27.0",
     "better-sqlite3": "^12.6.2",
     "js-yaml": "^4.1.0",
     "sqlite-vec": "^0.1.7"

package/sample-project/CLAUDE.md

@@ -185,6 +185,7 @@ Use these with `vault_write({ template: "name", path: "...", frontmatter: { tags
 | `moc` | Maps of Content (index/hub notes) |
 | `daily-note` | Daily notes |
 | `task` | Structured task notes with status, priority, due date |
+| `note` | Minimal generic notes |
 
 ## Session End