Usually the virtual environment or the packages are missing. Run /project-hub:setup and restart Claude Code. /project-hub:session-start reports "Setup unvollständig" (setup incomplete) if the venv, config.yaml or the Python dependencies are missing.
session-start detects a virtual environment from before the switch to mcp 2.x by a missing component. /project-hub:setup syncs the packages again and removes the old fastmcp.
That is the Microsoft Store placeholder for python. The skill then tries py -3 and known install locations. If it finds nothing, install Python 3.11 or newer from python.org with the option to add python.exe to PATH.
The server reads config.yaml only at startup. Restart Claude Code after a change.
The server makes up to five attempts (four retries) with increasing wait times. If the error persists, another process is writing or the database sits on a slow network share. Close other sessions that use the same database and try again.
If db_path lies in Dropbox, OneDrive, Google Drive or iCloud, the database can be silently corrupted. Move it to a local path or a real network share and restore it from a backup or a project export.
The active selection is a single entry in the database. Several Claude sessions or people using the same database overwrite it for each other. Reload the project with /project-hub:resume.
The slug is derived from the name. Choose a different name or continue with the existing project.
force.This is expected: changes affect only the database, and the file in the docs folder stays old. The database, reports and search are authoritative. See Technical details.
Updates write only non-empty values. An empty value leaves the field unchanged, and it can only be overwritten with other text.
The file name is derived from target folder, date and title slug, not from the note type. Notes with the same title on the same day therefore share a file if they land in the same folder. This also applies to different types: a note and a decision both go to misc/. The title slug is truncated to 50 characters, so different long titles with the same beginning can collide as well. Both notes remain in the database, only the older note's Markdown file is overwritten. Put a date or a distinguishing prefix at the start of the title.
Most skills need a loaded project. Use /project-hub:resume <name> or /project-hub:new-project.
The search ignores case for ASCII letters only. Umlauts must match in their case. In addition, % and _ in a search term act as wildcards.
| Message | Meaning |
|---|---|
| "Path traversal blocked" | The file is not below your home directory. |
| "Refusing to attach a hidden/dotfile path" | A part of the path starts with a dot. Copy the file to a normal location. |
| "File not found" | Wrong path or ~ not expanded. Give the full absolute path. |
| "Not a regular file" | The path points to a directory. Pass the individual files. |
If the .md file next to a PDF or Word document is missing, the conversion failed or was skipped, and the attachment itself is saved regardless.
generic, resume does not load knowledge documents. /project-hub:knowledge shows what is installed.~/.project-hub/knowledge/<project-type>/ and end in .md. If they are missing, /project-hub:knowledge sync installs the templates.No vacation-handover document exists for the project type. Create it with /project-hub:knowledge update vacation-handover. The plugin bundles a template only for merchant-onboarding.
skip: a project with this slug exists. Choose rename, or overwrite if the existing project should be replaced.overwrite: the import deletes the existing project with its contacts and notes and also removes its entire docs folder from disk. The notes' Markdown files and all attachment files are gone afterwards. Back up the folder first if you still need it.cdn.jsdelivr.net and needs an internet connection.action-item without a completion filter.