Skip to content

docs(qmd): fix vault path and mark old plan superseded#15

Merged
technicalpickles merged 2 commits into
mainfrom
docs/qmd-setup-fixes
Jun 29, 2026
Merged

docs(qmd): fix vault path and mark old plan superseded#15
technicalpickles merged 2 commits into
mainfrom
docs/qmd-setup-fixes

Conversation

@technicalpickles

Copy link
Copy Markdown
Owner

What

Sets up qmd semantic search against the real vault and fixes the docs that pointed at a path that doesn't exist.

The qmd tooling was already in the repo (the com.technicalpickles.qmd-refresh LaunchAgent), but nothing was installed: no collection, no index, agent unloaded. Got it running, then fixed the stale docs that sent it at the wrong path.

Changes

  • LaunchAgents/README.md — fix the collection path. The vault is at ~/Vaults/pickled-knowledge, not the nested ~/Vaults/pickled-knowledge/pickled-knowledge the doc claimed.
  • doc/plans/2026-02-01-qmd-refresh-launchagent.md — add a SUPERSEDED banner. The shipped agent diverged from this plan: runs via npx @tobilu/qmd (not a bun binary), is arm64-gated, and refreshes every 15 min with RunAtLoad.
  • bean dotfiles-uwhx — tracks the setup work (completed).

What actually got set up (on this machine, not in the PR)

  • Collection second-brain~/Vaults/pickled-knowledge (5712 files)
  • Index built: 10566 vectors, ~85MB at ~/.cache/qmd/index.sqlite
  • LaunchAgent symlinked + loaded; verified its first scheduled run embedded changed docs and exited clean

Notes

  • qmd needs the sandbox disabled (writes ~/.config/qmd, ~/.cache/qmd, fetches models from huggingface.co).
  • Metal GPU shader compile fails under launchd so it falls back to CPU. Full embed took ~13 min; incremental hourly runs are ~1s, so it's a non-issue in practice.

🤖 Generated with Claude Code

Set up the qmd semantic search collection against the real vault at
~/Vaults/pickled-knowledge. The README and 2026-02-01 plan both claimed
a nested ~/Vaults/pickled-knowledge/pickled-knowledge path that does not
exist.

- Fix the collection path in LaunchAgents/README.md
- Add a SUPERSEDED banner to the old plan doc (it described a bun-based
  install; the shipped agent uses npx @tobilu/qmd, arm64-gated, every 15m)
- Track the setup work in bean dotfiles-uwhx (completed)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@technicalpickles technicalpickles merged commit 92965df into main Jun 29, 2026
1 check passed
@technicalpickles technicalpickles deleted the docs/qmd-setup-fixes branch June 29, 2026 02:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant