Init

Bootstrap a new AI Knowledgebase vault in the current working directory.

No arguments — operates on the current directory.

Step 1: Dependency Check

Verify all required dependencies before any filesystem work. Check each one:

Dependency	Check	Install
Node.js	command -v node	Install via system package manager
Python 3	command -v python3	Install via system package manager
marker-pdf	command -v marker_single	pip install marker-pdf
qmd	command -v qmd	npm install -g @tobilu/qmd
knowledge-graph	KNOWLEDGE_GRAPH_PATH env var is set and directory exists	export KNOWLEDGE_GRAPH_PATH=/path/to/obra/knowledge-graph

Run all checks. Collect all missing dependencies.

If any are missing: report each missing dependency with its install command, then stop. Do not proceed to vault creation.

If all present: proceed silently to Step 2.

Step 2: Run Init Script

Run the ai-knowledgebase-init script using the Bash tool:

ai-knowledgebase-init

The script creates PARA folders, seed files, Templater templates, .mcp.json, and .claude/settings.json in the current directory. All operations are idempotent — existing artifacts are skipped.

Capture and display the script output (created/skipped status for each artifact).

Step 3: Generate CLAUDE.md

Skip if CLAUDE.md already exists in the current directory.

Generate a CLAUDE.md file in the vault root with the following content:

• Vault identity — vault name derived from the current directory name (e.g., directory my-notes becomes vault name "my-notes")
• Folder purpose summary:
  • 1 - Areas/ — AI-compiled knowledge articles synthesized from source material
  • 2 - Resources/ — Source material inbox (PDFs, EPUBs, markdown, web clips)
  • 3 - Permanent/ — User's own thinking, evergreen notes
  • 4 - Fleeting/ — Quick captures, ideas, scratch notes
  • 9 - Meta/ — Vault infrastructure (manifest, catalog, hot cache, templates)
• Skill references (one-line descriptions only, no full definitions):
  • /ai-knowledgebase:compile — Process resources into structured area articles
  • /ai-knowledgebase:save — Capture knowledge from the current conversation into the vault
  • /ai-knowledgebase:audit — Health-check, cross-linking, and structural maintenance

Write the file, then report created: CLAUDE.md.

Step 4: Register with qmd

Run:

qmd collection add <cwd> --name <dir-name>

Where <cwd> is the current working directory path and <dir-name> is the directory name.

• On success: report registration complete
• On failure: warn that qmd registration failed but the vault is still functional — search will not be available until registered manually

Step 5: Summary

Report a summary of all artifacts: what was created and what was skipped.