Troubleshooting

First check: run doctor

link-garden doctor

This catches common consistency and safety issues early. If the index is stale, use:

link-garden doctor --rebuild-index
link-garden doctor --fix

Common issues

link-garden command not found

Activate your virtual environment and reinstall editable package:

pip install -e ".[dev]"

No rows from link-garden list

You may be in the wrong directory, filtered too narrowly, or only have archived entries. Try:

link-garden list --include-archived --limit 200

Import creates duplicates or updates unexpected rows

Recheck dedupe mode. both (default) uses GUID first, then normalized URL fallback.

link-garden import-chrome --bookmarks-file ./Bookmarks --dedupe both --dry-run

Export fails for scope all

Full-scope export requires explicit opt-in:

link-garden export --format html --out ./exports --scope all --dangerous-all

Serve refuses non-localhost bind

When require_allow_remote: true, you must explicitly opt in:

link-garden serve --host 0.0.0.0 --allow-remote

Doctor reports private export leak

Rebuild a clean public export and stop publishing broad-scope output.

link-garden export --format html --out ./exports --scope public

Index repair directly

link-garden rebuild-index --dry-run
link-garden rebuild-index

rebuild-index rescans Markdown files and reconstructs data/index.json.