### Quick Install using Git Clone and Setup Script

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/INSTALL.md

Clones the repository and runs the setup script for a quick installation. This is recommended for most users.

```bash
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git ~/obsidian-llm-wiki-src
cd ~/obsidian-llm-wiki-src && ./setup
```

--------------------------------

### Clone and Setup LLMwiki

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/GUIDE.md

Clone the LLMwiki repository and run the setup script for installation. This is the initial step to get LLMwiki running on your system.

```bash
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git ~/obsidian-llm-wiki-src
cd ~/obsidian-llm-wiki-src && ./setup
```

```powershell
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git "$HOME\obsidian-llm-wiki-src"
cd "$HOME\obsidian-llm-wiki-src"; .\setup.ps1
```

--------------------------------

### Install Prompt Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/smoke/04-recording-notes.md

This snippet represents the initial installation prompt that should be pasted into the Claude Code terminal. It's the starting point for the demonstration.

```bash
$ <paste 01-install-prompt.md contents>
```

--------------------------------

### Install LLM Wiki

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/gif-script.md

Clone the LLM wiki repository and run the setup script. This is the initial setup command.

```bash
Install LLMwiki: git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki ~/.claude/skills/vault-wiki && cd ~/.claude/skills/vault-wiki && ./setup
```

--------------------------------

### Per-Host Installation with Setup Script

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/INSTALL.md

Installs the wiki for specific agent hosts using the setup script with the --host flag. Choose the command corresponding to your agent.

```bash
./setup --host claude     # ~/.claude/skills/vault-wiki
./setup --host codex      # ~/.codex/skills/vault-wiki
./setup --host opencode   # ~/.config/opencode/skills/vault-wiki
./setup --host gemini     # ~/.gemini/skills/vault-wiki
```

--------------------------------

### Clone and Setup LLMwiki

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Quickly clone the repository and run the setup script to install LLMwiki. Specify your host (e.g., claude, codex, gemini) to configure the agent.

```bash
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git
cd obsidian-llm-wiki && ./setup                      # --host claude | codex | opencode | gemini
```

--------------------------------

### Per-Host Installation with PowerShell Setup Script

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/INSTALL.md

Installs the wiki for specific agent hosts using the PowerShell setup script. Use -DryRun to preview changes without modifying files.

```powershell
.\setup.ps1 -VaultHost claude
.\setup.ps1 -VaultHost claude -DryRun     # preview without writing
```

--------------------------------

### Clone and Setup Obsidian LLM Wiki

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/smoke/01-install-prompt.md

Use this command to clone the repository and run the setup script. Ensure you have Git installed.

```bash
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki ~/.claude/skills/vault-wiki && cd ~/.claude/skills/vault-wiki && ./setup
```

--------------------------------

### Setup LLMwiki with Explicit Host

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/GUIDE.md

Run the setup script for LLMwiki, explicitly selecting the desired host. This allows customization of the installation based on the preferred AI model provider.

```bash
./setup --host claude     # default
./setup --host codex
./setup --host opencode
./setup --host gemini
```

--------------------------------

### Setup LLMwiki on Windows (PowerShell)

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Installs LLMwiki on Windows using PowerShell. The setup script configures the agent with the necessary skills and MCP configuration.

```powershell
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git
cd obsidian-llm-wiki; .\setup.ps1
```

--------------------------------

### Manual Installation Steps

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/INSTALL.md

Manually copies project files to the host's skills directory if the setup script is not used. Ensure to pick the correct HOST_DIR for your agent.

```bash
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git
cd obsidian-llm-wiki

# pick your host's skills dir
HOST_DIR="$HOME/.claude/skills/vault-wiki"
mkdir -p "$HOST_DIR/mcp-server"

cp -r skills examples docs terrariums viewer smoke "$HOST_DIR/"
cp README.md CHANGELOG.md RELEASE_NOTES.md vercel.json "$HOST_DIR/"
cp mcp-server/bundle.js mcp-server/package.json "$HOST_DIR/mcp-server/"
```

--------------------------------

### recipe.show

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/mcp-tools-reference.md

Displays a recipe's frontmatter and setup guide.

```APIDOC
## recipe.show

### Description
Show a recipe's frontmatter and setup guide

### Method
Not specified (assumed to be a query operation)

### Endpoint
Not specified

### Parameters
#### Query Parameters
- **id** (string, required) — Recipe id (e.g. x-to-vault)
```

--------------------------------

### Update README Quick-Start

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

The README quick-start command has been fixed to correctly clone the repository into a sibling directory, preventing the old command from bypassing the setup entirely by cloning into the install directory.

```bash
README quick-start fixed (clones to sibling dir; old command cloned full repo into install dir, bypassing setup entirely)
```

--------------------------------

### Setup Script (POSIX Bash)

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

A POSIX bash script for setting up the project environment. It supports different hosts, dry runs, and installs skill files to user-specific directories. It does not use sudo or install external package managers.

```bash
setup --host claude --dry-run
```

```bash
setup --host codex|opencode|gemini --dry-run
```

```bash
setup --host claude
```

--------------------------------

### Setup Script with Explicit Allowlist

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

The setup script now uses an explicit allowlist for files and directories to be copied, improving installation leanness. It fails fast if the bundle is missing. The PowerShell variant uses -VaultHost.

```powershell
setup /setup.ps1: explicit allowlist (skills, examples, docs, terrariums, viewer, smoke, top-level docs, mcp-server/{bundle.js, package.json}). Fail fast if bundle missing. PS variant uses -VaultHost (not -Host -- $Host is reserved in PowerShell).
```

--------------------------------

### Setup Script (PowerShell)

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

The PowerShell equivalent of the setup script, maintaining the same semantics for host selection and dry runs.

```powershell
setup.ps1
```

--------------------------------

### Verify Install with Probe

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/INSTALL.md

Boots the bundle directly with a probe to verify the installation. Checks for correct server name and protocol version in the JSON-RPC response.

```bash
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}' \
  | VAULT_PATH=/path/to/your/vault node ~/.claude/skills/vault-wiki/mcp-server/bundle.js
```

--------------------------------

### Installation and Usage Recipe

Source: https://github.com/2233admin/obsidian-llm-wiki/wiki/Obsidian-Native-CLI-Comparison

Instructions for installing both the native Obsidian CLI and the obsidian-llm-wiki MCP. Recommends using the MCP for most agent workflows and the native CLI for plugin-specific tasks.

```bash
# Install both
brew install obsidian  # or your platform's installer; enable CLI in Settings
git clone https://github.com/2233admin/obsidian-llm-wiki.git && cd obsidian-llm-wiki && ./setup

# Use obsidian-llm-wiki MCP for 95% of agent workflow
# (it's headless, safe, works when Obsidian is closed)

# Use `obsidian eval ...` for the 5% that genuinely needs plugin runtime
# (Templater rendering, Dataview queries, Importer conversions)
```

--------------------------------

### Clone and Setup Output

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/smoke/04-recording-notes.md

This output shows the expected messages during the cloning and setup process of the vault-wiki. It indicates the successful execution of automated setup scripts.

```bash
Cloning into 'vault-wiki'...
Running setup script...
Done! Your vault is ready.
```

--------------------------------

### Install Dreamtime

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/recipes/dreamtime-to-vault.md

Install the dreamtime-open package using pip and run the dreamtime install command. This is a prerequisite for using Dreamtime's session distillation features.

```bash
pip install dreamtime-open
dreamtime install
```

--------------------------------

### Clone LLMwiki Repository

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/RELEASE_NOTES.md

Clone the LLMwiki repository to get started. This command fetches the latest code.

```bash
git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git
```

--------------------------------

### Start Voile Docker Compose

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/recipes/voile-to-vault.md

Starts the Voile services using Docker Compose. Ensure you are in the Voile repository directory before running this command.

```bash
cd <path-to-voile-repo>
docker compose up -d
```

--------------------------------

### Setup LLMwiki for OpenCode Host

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Configures LLMwiki to work with the OpenCode host. The path is configured and smoke-tested.

```bash
./setup --host opencode
```

--------------------------------

### Setup LLMwiki for Gemini Host

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Configures LLMwiki to work with the Gemini CLI host. The path is configured and smoke-tested.

```bash
./setup --host gemini
```

--------------------------------

### Run Gmail Setup Script

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/recipes/gmail-to-vault.md

Execute the one-time setup script to obtain a durable GMAIL_REFRESH_TOKEN. This script requires your client ID and secret to initiate the OAuth flow.

```bash
GMAIL_CLIENT_ID=xxx GMAIL_CLIENT_SECRET=xxx bun run recipes/collectors/gmail-setup.ts
```

--------------------------------

### Frontmatter Configuration Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

An example configuration file for the frontmatter generator. It includes presets for various LLMs, canonical lists for status and type, folder-to-type mappings, status rules, and a tag blacklist.

```json
{
  "llm_presets": {
    "anthropic": {
      "model": "claude-3-opus-20240229",
      "temperature": 0.7
    },
    "qwen": {
      "model": "qwen-turbo",
      "temperature": 0.7
    },
    "doubao": {
      "model": "doubao-pro-1.0",
      "temperature": 0.7
    },
    "minimax": {
      "model": "abab6-0104",
      "temperature": 0.7
    }
  },
  "canonical_status": ["draft", "in progress", "completed", "on hold", "cancelled"],
  "canonical_type": ["article", "blog post", "documentation", "project", "meeting notes"],
  "folder_type_map": {
    "/projects": "project",
    "/docs": "documentation"
  },
  "status_rules": {
    "completed": {
      "requires_review": false
    }
  },
  "tag_blacklist": ["temp", "ignore", "draft"]
}
```

--------------------------------

### Configuration Override Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/creatures/README.md

Shows how to switch between Anthropic and Minimax providers by adjusting authentication modes and base URLs.

```yaml
auth_mode: anthropic-key
# ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN
---
auth_mode: api-key
MINIMAX_API_KEY + base_url: https://api.minimaxi.com/v1

```

--------------------------------

### Vault Structure Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/GUIDE.md

Illustrates the recommended vault structure, showing where the AI-Output directory is created relative to existing notes.

```shell
your-vault/
├── (your existing notes, untouched)
└── 00-Inbox/
    └── AI-Output/
        ├── vault-architect/
        ├── vault-gardener/
        └── ...

```

--------------------------------

### AI-Output Frontmatter Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/GUIDE.md

Example of provenance frontmatter for saved AI-generated analysis notes, including generation details and source nodes.

```yaml
---
generated-by: vault-architect
generated-at: 2026-04-21T14:32:00.000Z
agent: claude-opus-4-7
parent-query: "refactor authentication module"
source-nodes:
  - "[[auth-architecture]]"
  - "[[session-tokens]]"
status: draft
scope: project
quarantine-state: new
---

```

--------------------------------

### Setup LLMwiki for Codex Host

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Configures LLMwiki to work with the Codex CLI host. The path is configured and smoke-tested.

```bash
./setup --host codex
```

--------------------------------

### Setup LLMwiki for Claude Host

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Configures LLMwiki to work with the Claude Code host. This is a primary target and fully exercised.

```bash
./setup --host claude
```

--------------------------------

### Vault-Mind Configuration Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/2026-04-07-vault-mind-design.md

Example YAML configuration file for vault-mind, showing settings for vault path and enabling/configuring various adapters like filesystem, obsidian, memu, gitnexus, and dreamtime.

```yaml
# vault-mind.yaml (vault 根目录)
vault_path: "/path/to/your/vault"
adapters:
  filesystem:
    enabled: true  # 默认
  obsidian:
    enabled: true
    ws_url: "ws://127.0.0.1:27124"
    token: "${VAULT_MIND_OBSIDIAN_TOKEN}"
  memu:
    enabled: true
    pg_url: "postgresql://boris:***@localhost:5432/memu"
  gitnexus:
    enabled: false  # 用户没装就 false
  dreamtime:
    enabled: true
```

--------------------------------

### Role-Owned AI-Output Path Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/HOST_ADAPTERS.md

An example of a file path for role-owned AI-Output, used for knowledge role analyses. This output is also stored in a quarantine draft.

```text
00-Inbox/AI-Output/vault-librarian/YYYY-MM-DD-attention-heads.md
```

--------------------------------

### Host-Owned AI-Output Path Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/HOST_ADAPTERS.md

An example of a file path for host-owned AI-Output, typically used for session closeouts and agent work records. This output is stored in a quarantine draft.

```text
00-Inbox/AI-Output/codex/YYYY-MM-DD-fix-release-loop.md
```

--------------------------------

### Obsidian Native CLI Examples

Source: https://github.com/2233admin/obsidian-llm-wiki/wiki/Obsidian-Native-CLI-Comparison

Execute common Obsidian CLI commands for daily notes, plugin evaluation, and search. Requires Obsidian to be running.

```bash
obsidian daily              # create today's daily note via Templater
obsidian eval "app.commands.executeCommandById('obsidian-importer:open-modal')"
obsidian search "query"     # Obsidian's own search with fulltext + cache
```

--------------------------------

### Run MCP Server

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/CLAUDE.md

Command to start the MCP server in development mode. Requires navigating to the mcp-server directory.

```bash
cd mcp-server && npm run dev
```

--------------------------------

### Cold Start Search

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Use this command when you want to query your vault without any prior context. It's a direct way to ask for information.

```bash
/vault-librarian what do I know about attention heads
```

--------------------------------

### Building from Source with npm

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/INSTALL.md

Builds the project from source, typically only needed if you have modified the mcp-server/src/ directory. Installs dependencies and rebuilds the bundle.js.

```bash
cd mcp-server
npm install            # installs ws, MCP SDK, pglite, esbuild devDep
npm run rebuild        # tsc -> dist/, then esbuild --bundle -> bundle.js
```

--------------------------------

### Smoke Test Verification

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Verifies that the setup script for all hosts prints correct target directories and paste-able JSON/Markdown snippets, and that invalid hosts fail cleanly.

```bash
setup --dry-run all 4 hosts (claude/codex/opencode/gemini)
```

--------------------------------

### Git Commit for README

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Example of an atomic commit on the v2-staging branch, updating the README with installation instructions.

```git
3f56883 docs(readme) -- v2 README + WHY_NOT_JUST_GREP + INSTALL
```

--------------------------------

### Git Commit for Scaffold

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Example of an atomic commit on the v2-staging branch, integrating setup, viewer, and Vercel deployment.

```git
d9a5e88 feat(scaffold) -- setup + viewer + vercel
```

--------------------------------

### Installation Confirmation

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/smoke/04-recording-notes.md

This is the success message displayed after the vault-wiki has been successfully installed. It confirms the installation and lists the available personas.

```bash
[vault-wiki] installed successfully
6 personas ready: librarian, architect, curator, teacher, historian, janitor
```

--------------------------------

### Reproduce memU Adapter Performance Baseline

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/PERF-MEMU.md

Run this command to reproduce the performance baseline measurements. Ensure you are in the 'mcp-server' directory and have built the project.

```bash
cd mcp-server
npm run build
node dist/scripts/memu-perf.js --iters 20 --query openclaw
```

--------------------------------

### Vault Mind Minimum Installation Script

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/2026-04-07-vault-mind-design.md

This bash script performs a minimal installation of Vault Mind. It detects the environment, installs dependencies, generates configuration, and sets up skills and hooks.

```bash
# 最小安装 (任何人)
git clone https://github.com/2233admin/vault-mind ~/.vault-mind
cd ~/.vault-mind && bash setup.sh /path/to/your/vault

# setup.sh 做什么:
# 1. 检测环境 (Node.js, Python, Claude Code / OpenClaw)
# 2. npm install mcp-server deps
# 3. pip install compiler deps (minimal)
# 4. 生成 vault-mind.yaml (交互式: 你有 Obsidian? memU? GitNexus?)
# 5. 注册 MCP server 到 Claude Code / OpenClaw settings
# 6. 安装 skills 到 ~/.claude/skills/vault-mind/
# 7. 可选: 注册 cron hooks
# 8. 跑 vault-mind init -- 生成 _CLAUDE.md + index.md + log.md (如果没有)
```

--------------------------------

### Git Commit for Examples

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Example of an atomic commit on the v2-staging branch, including demo-vault notes and graph data.

```git
cec28b6 feat(examples) -- demo-vault (10 notes + graph)
```

--------------------------------

### Project Initialization and Status Check

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Commands to navigate to the project directory, check the Git status, and view the recent progress log. This is the typical starting sequence for a new development session.

```bash
cd D:/projects/obsidian-llm-wiki && git status && tail -200 progress.txt
```

--------------------------------

### Git Commit for Example Fix

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Example of an atomic commit on the v2-staging branch, fixing the graph.json to resolve an unresolved edge count.

```git
7c1729a fix(examples) -- rebuild graph.json (unresolved=1 fix)
```

--------------------------------

### Obsidian-llm-wiki MCP Call Example

Source: https://github.com/2233admin/obsidian-llm-wiki/wiki/Obsidian-Native-CLI-Comparison

Example of an MCP call to retrieve the vault graph. This is a headless operation and does not require Obsidian to be running.

```jsonc
// MCP call from any agent
{"method": "tools/call", "params": {
  "name": "vault.graph",
  "arguments": {"type": "both"}
}}
```

--------------------------------

### Warm Start Search with Specific Note

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/README.md

Use this command when you want to explain a specific note within the context of your other related notes. This provides more focused and relevant explanations.

```bash
/vault-librarian explain [[retrieval-augmented-generation]] in the context of my other notes on LLMs
```

--------------------------------

### Compiler Stderr Output Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/examples/demo-vault/README.md

Example of the standard error output from the concept graph build process, showing scanned nodes, edges, and unresolved links.

```text
[concept_graph] scanned=10 nodes=10 edges=69 (wikilink=40 tag=29) unresolved=1 -> .compile/specB-demo-vault/.compile/graph.json
```

--------------------------------

### Initialize Collaboration Layout

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/TEAM_VAULT_SETUP.md

Use the provided Python script to set up the necessary directories, configuration files, and gitignore for collaboration within the vault. Specify the vault path, team members, and agents.

```bash
python scripts/init_collab_vault.py --vault /path/to/team-vault --team alice,bob --agents codex,claude
```

--------------------------------

### Translate Report Headings Example (Chinese)

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/skills/vault-ingest.md

Example of translating report headings for a specific language user (Chinese). This ensures consistency in the user's preferred language.

```markdown
Translate ALL report headings: "## 摄入报告：", "**已创建：**", "**已更新：**", "**发现矛盾：**" for Chinese users.
```

--------------------------------

### Reproducing the KT Build

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/KT_DOGFOOD.md

Commands to clone the repository, run the KT terrarium team, and interact with the librarian agent.

```bash
# Clone the terrarium
git clone https://github.com/2233admin/obsidian-llm-wiki
cd obsidian-llm-wiki

# Run the KT team
kt terrarium run @vault-wiki/terrariums/vault-wiki-team

# Ask the librarian
send_message tasks "what do I know about attention heads"
```

--------------------------------

### Install Git Hook for Conflict Prevention

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/CONFLICT_RESOLUTION.md

Install this Git hook to automatically run conflict detection before each commit. This helps prevent dirty commits by ensuring no sync conflicts are present.

```bash
python scripts/install_vault_git_hook.py --vault /path/to/vault
```

--------------------------------

### vault.init

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/mcp-tools-reference.md

Scaffolds a new knowledge base topic within the vault, creating a new directory and setting up initial structure.

```APIDOC
## vault.init

### Description
Scaffold a new knowledge base topic

### Method
Not specified (assumed to be a tool operation)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **topic** (string, required) — Topic name (used as directory name and KB title)
```

--------------------------------

### Unified Query Function Example

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/2026-04-07-vault-mind-design.md

Illustrates the internal workflow of a unified query function, showing how it searches across multiple adapters and merges/ranks the results based on source weighting.

```typescript
// query.unified("attention mechanism") 的内部流程:
async function unifiedQuery(query: string, opts?: QueryOpts): Promise<UnifiedResult[]> {
  // 1. 向所有有 search capability 的 adapter 并行发起搜索
  const results = await Promise.all(
    adapters
      .filter(a => a.capabilities.includes("search"))
      .map(a => a.search(query, opts))
  )
  
  // 2. 融合排序 (source-weighted)
  //    vault 结果 weight=1.0, memU weight=0.8, gitnexus weight=0.6
  //    权重可配置
  return mergeAndRank(results, opts?.weights)
}
```

--------------------------------

### Install Vault Git Hook

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/TEAM_VAULT_SETUP.md

Install the pre-commit hook to prevent local issues and policy errors from being pushed to Gitea. Copy Gitea CI templates and optional reviewer files for server-side checks and PR customization.

```bash
python scripts/install_vault_git_hook.py --vault /path/to/team-vault
```

--------------------------------

### Unified Query with Custom Weights

Source: https://github.com/2233admin/obsidian-llm-wiki/wiki/Adapter-Spec

Example of how to use the query.unified operation with custom weights to prioritize specific adapters. This allows fine-tuning the balance between authoritative filesystem results and suggestive semantic results.

```yaml
query.unified { query: "...", weights: { memu: 1.5, filesystem: 0.7 } }
```

--------------------------------

### Git Commit for Personas

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/progress.txt

Example of an atomic commit on the v2-staging branch, adding skills and creature configurations.

```git
e752ba9 feat(personas) -- 6 skills + KT creature configs
```

--------------------------------

### Register Help Query Tool

Source: https://github.com/2233admin/obsidian-llm-wiki/blob/main/docs/HELP-ENDPOINT-PROPOSAL.md

Integrates the `queryHelp` function as a tool named 'query_help' into the server. This tool provides sub-second concept lookup and should be used before full-text search for known terms.

```typescript
// D:/projects/obsidian-llm-wiki/src/server.ts (existing file, add tool)
import { queryHelp } from './tools/help.js';

server.tool(
  'query_help',
  'Sub-second concept lookup against vault. Returns structured {type, title, summary, content, related_concepts}. Zero LLM calls. Use this BEFORE vault_search when user asks about a known concept by name.',
  {
    q: { type: 'string', description: 'concept name, note title, or endpoint path' },
    include_content: { type: 'boolean', description: 'include full markdown body (default true)', default: true },
  },
  async ({ q, include_content }) => {
    const result = queryHelp(q, { include_content });
    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
  }
);

```