Fastest way to scaffold your LLM powered personal knowledge base - Obsidian, Claude Code, qmd, Github
JavaScript aiampclaude-codecodexcursorgithubknowledge-baseknowledge-graphknowledge-managementllmobsidianobsidian-vaultqmdsecond-brain
feat: remove qmd-cli skill
jessepinkman9900c975eadecd46
diff --git a/.claude/skills/pack-test/SKILL.md b/.claude/skills/pack-test/SKILL.mdindex b37b494..0d7734b 100644--- a/.claude/skills/pack-test/SKILL.md+++ b/.claude/skills/pack-test/SKILL.md@@ -159,7 +159,7 @@ RESOLVED_B=$(npx -y claude-second-brain-$(node -p "require('./package.json').ver| `.gitignore` (not `.gitignore.template`) | Present in both brains | || `wiki/{index,log,overview}.md`, `sources/`, `qa/` | Present in both brains | || `raw-sources/{articles,pdfs,personal}/` | Present in both brains | |-| `.claude/skills/` — 7 subdirs | brain-ingest, brain-search, brain-refresh, brain-rebuild, lint, qmd-cli, setup | |+| `.claude/skills/` — 6 subdirs | brain-ingest, brain-search, brain-refresh, brain-rebuild, lint, setup | || `scripts/qmd/{setup,reindex}.ts` | Present in both brains, DB hardcoded to `.qmd/index.sqlite` relative | || `CLAUDE.md`, `mise.toml`, `package.json` | Present in both brains | || `CLAUDE.md` INDEX_PATH | Relative `INDEX_PATH=.qmd/index.sqlite` (no absolute substitution) | |diff --git a/.github/workflows/pack-test.yml b/.github/workflows/pack-test.ymlindex 369b52e..040df45 100644--- a/.github/workflows/pack-test.yml+++ b/.github/workflows/pack-test.yml@@ -62,7 +62,6 @@ jobs:check ".claude/skills/brain-refresh" "$VAULT/.claude/skills/brain-refresh"check ".claude/skills/brain-rebuild" "$VAULT/.claude/skills/brain-rebuild"check ".claude/skills/lint" "$VAULT/.claude/skills/lint"- check ".claude/skills/qmd-cli" "$VAULT/.claude/skills/qmd-cli"check "scripts/qmd/setup.ts" "$VAULT/scripts/qmd/setup.ts"check "scripts/qmd/reindex.ts" "$VAULT/scripts/qmd/reindex.ts"check "package.json" "$VAULT/package.json"diff --git a/CLAUDE.md b/CLAUDE.mdindex acd2d13..2f87a42 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -240,7 +240,7 @@ Whenever you **add, remove, or rename a skill** under `template/.claude/skills/`1. **`README.md`** (root) — the "Claude Code skills included" section and the "Installing and updating skills" block. Bump the skill count ("N wiki skills") in the install commands.2. **`template/README.md`** — the "Your Claude Code skills" section and the "Installing and updating skills" block. Bump the skill count.-3. **`bin/create.js`** — the `GLOBAL_SKILLS` array (top of the file) if the skill should be installed globally (`~/.claude/skills/`). `brain-ingest`, `brain-search`, `brain-refresh` are global today; `brain-rebuild`, `lint`, `setup`, `qmd-cli` are vault-local.+3. **`bin/create.js`** — the `GLOBAL_SKILLS` array (top of the file) if the skill should be installed globally (`~/.claude/skills/`). `brain-ingest`, `brain-search`, `brain-refresh` are global today; `brain-rebuild`, `lint`, `setup` are vault-local.4. **`.github/workflows/pack-test.yml`** — add a `check` line for the new vault-local skill directory, and if the skill is global, add `check` lines for `$HOME/.claude/skills/<name>/SKILL.md` and `$HOME/.claude/skills/<name>/.csb-version`, plus `grep_check` lines for `claude-second-brain path` and `claude-second-brain qmd` (global skills use the CLI proxy, not a baked INDEX_PATH).5. **`.claude/skills/pack-test/SKILL.md`** — update the expected-skills comment, the `ls` and `grep` commands in Step 3, the checklist table (including the "N subdirs" count), and the cleanup / overwrite-warning note in Step 4.diff --git a/README.md b/README.mdindex 38851df..b4f07e9 100644--- a/README.md+++ b/README.md@@ -268,14 +268,14 @@ npx claude-second-brain qmd -- query -c wiki "<terms>" # run qmd against the d## Installing and updating skills-Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md`. `/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, `/setup`, and `/qmd-cli` live inside the vault at `.claude/skills/`.+Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md`. `/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, and `/setup` live inside the vault at `.claude/skills/`.### Update the built-in wiki skillsThe wiki's own skills are scaffolded at creation time. To pull in improvements, use `npx skills` pointing to the template skills directory in this repo:```bash-# Install or update all 7 wiki skills from the latest template+# Install or update all 6 wiki skills from the latest templatenpx skills add https://github.com/jessepinkman9900/claude-second-brain/tree/main/template/.claude/skills -a claude-code -y# Or update a specific skilldiff --git a/docs/pages/skills.mdx b/docs/pages/skills.mdxindex 942302b..c998610 100644--- a/docs/pages/skills.mdx+++ b/docs/pages/skills.mdx@@ -19,12 +19,12 @@ The wiki ships with a set of Claude Code slash commands that cover the full work## Install or update skills-`/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, `/setup`, and `/qmd-cli` live inside the vault at `.claude/skills/`.+`/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, and `/setup` live inside the vault at `.claude/skills/`.To pull in improvements from the latest template:```bash-# Install or update all 7 wiki skills+# Install or update all 6 wiki skillsnpx skills add https://github.com/jessepinkman9900/claude-second-brain/tree/main/template/.claude/skills -a claude-code -y# Or update a specific skilldiff --git a/template/.claude/skills/brain-rebuild/SKILL.md b/template/.claude/skills/brain-rebuild/SKILL.mdindex 91904bc..e52e636 100644--- a/template/.claude/skills/brain-rebuild/SKILL.md+++ b/template/.claude/skills/brain-rebuild/SKILL.md@@ -66,7 +66,7 @@ Edit `scripts/qmd/setup.ts` to reflect the new schema:If collection names changed:- Update every occurrence in `CLAUDE.md` (e.g. `qmd query -c wiki` → new name)-- Update `.claude/skills/brain-ingest/SKILL.md`, `.claude/skills/brain-search/SKILL.md`, `.claude/skills/lint/SKILL.md`, `.claude/skills/qmd-cli/SKILL.md` — anywhere collection names are hard-coded+- Update `.claude/skills/brain-ingest/SKILL.md`, `.claude/skills/brain-search/SKILL.md`, `.claude/skills/lint/SKILL.md` — anywhere collection names are hard-coded- Use Grep to find any remaining stale references before moving on### Step 7 — Tear down the old schemadiff --git a/template/.claude/skills/qmd-cli/SKILL.md b/template/.claude/skills/qmd-cli/SKILL.mddeleted file mode 100644index 2ed7409..0000000--- a/template/.claude/skills/qmd-cli/SKILL.md+++ /dev/null@@ -1,168 +0,0 @@-----name: qmd-cli-description: 'Use qmd CLI to manage collections, index documents, search, and query a local semantic knowledge base. Use when the user mentions qmd, searching a collection, indexing files, running queries, hybrid search, BM25, vector search, or managing a document index. Covers: collection add/list/remove/rename, context management, get/multi-get, update, embed, query, search, vsearch, and MCP server commands.'-argument-hint: 'qmd command to run or describe what you want to do (e.g., "query wiki for X", "add folder to collection")'------# qmd CLI--Local semantic document index with hybrid search (BM25 + vector), collection management, and MCP server.--## Vault DB--This vault keeps its index at `.qmd/index.sqlite` (relative to the vault root). All CLI commands below run from the vault root and **must** prefix with `INDEX_PATH=.qmd/index.sqlite`:--```bash-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query -c wiki "..."-```--The scripts `pnpm qmd:setup` and `pnpm qmd:reindex` write to this same file. The CLI must match.-------## Collection Management--```bash-# Create/index a collection-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection add <path> --name <name> --mask <glob-pattern>-# e.g.:-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection add wiki --name wiki --mask "**/*.md"--# List all collections with details-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection list--# Remove a collection-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection remove <name>--# Rename a collection-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection rename <old-name> <new-name>-```--## Listing Files--```bash-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd ls-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd ls [collection[/path]]-```--## Context--```bash-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd context add [path] "description text"-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd context list-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd context rm <path>-```--## Retrieving Documents--```bash-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd get <file>[:line] [-l N] [--from N]-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd multi-get <pattern> [-l N] [--max-bytes N]-```--**Multi-get format flags:** `--json`, `--csv`, `--md`, `--xml`, `--files`--## Indexing & Maintenance--```bash-# Show index status and collections-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd status--# Re-index all collections-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd update [--pull]--# Create vector embeddings (900 tokens/chunk, 15% overlap)-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd embed [-f]--# Remove cache and orphaned data, vacuum DB-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd cleanup-```--> After bulk ingest sessions, run `update` then `embed` to keep the index fresh.--## Search & Query--| Command | Description |-|---------|-------------|-| `qmd query <query>` | **Recommended** — hybrid search with query expansion + reranking |-| `qmd search <query>` | Full-text keyword search (BM25, no LLM) |-| `qmd vsearch <query>` | Pure vector/semantic similarity search |--### Search Options--```--n <num> Number of results (default: 5, or 20 for --files)---all Return all matches (use with --min-score to filter)---min-score <num> Minimum similarity score---full Output full document instead of snippet---line-numbers Add line numbers to output---files Output docid,score,filepath,context---json JSON output with snippets---csv CSV output---md Markdown output---xml XML output--c, --collection <name> Filter results to a specific collection-```--### Examples--```bash-# Hybrid search across all collections-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query "distributed systems consensus"--# Search only the wiki collection, JSON output-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query -c wiki "transformer architecture" --json--# Keyword-only search, top 10, markdown output-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd search -c wiki "kafka" -n 10 --md--# Vector search with full documents-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd vsearch "attention mechanism" --full--# Filter by score threshold-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query "machine learning" --all --min-score 0.7-```--## MCP Server--```bash-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp --http [--port N]-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp --http --daemon-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp stop-```--## Global Options--```---index <name> Use a custom index name (default: index)-```--Note: use `INDEX_PATH` env var rather than `--index` — `INDEX_PATH` accepts a file path while `--index` only accepts a short name mapped to `~/.cache/qmd/`.--## Typical Workflows--### First-time setup for this vault-```bash-# Handled by the /setup skill:-pnpm qmd:setup-pnpm qmd:reindex-```--### After a bulk ingest session-```bash-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd update-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd embed-```--### Research workflow-```bash-# Discover relevant pages-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query -c wiki "<topic>"--# Get a specific file-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd get wiki/distributed-systems.md--# Get multiple related files-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd multi-get "wiki/kafka.md,wiki/distributed-systems.md" --md-```diff --git a/template/README.md b/template/README.mdindex c520d7d..875b1a1 100644--- a/template/README.md+++ b/template/README.md@@ -158,14 +158,14 @@ claude-second-brain/## Installing and updating skills-Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md` in this vault. The wiki ships with `/brain-ingest`, `/brain-search`, `/brain-refresh`, `/brain-rebuild`, `/lint`, `/setup`, and `/qmd-cli` pre-installed.+Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md` in this vault. The wiki ships with `/brain-ingest`, `/brain-search`, `/brain-refresh`, `/brain-rebuild`, `/lint`, and `/setup` pre-installed.### Update built-in wiki skillsPull the latest skills from the upstream template:```bash-# Install or update all 7 wiki skills+# Install or update all 6 wiki skillsnpx skills add https://github.com/jessepinkman9900/claude-second-brain/tree/main/template/.claude/skills -a claude-code -y# Or update a specific skill