AI-agent workflow // Knowledge & workflow

Maintained

Logseq Housekeeper

Reduces maintenance friction in a large Logseq knowledge base.

TL;DR Logseq Housekeeper is an open-source Python tool by Juan Mackie that scans a Logseq graph for unlinked mentions and proposes sensible wikilinks, turning recurring graph cleanup into a single review step.

Year started
2026
Role
Author.
Evidence stage
5/9: Used by Juan
Last reviewed
2026-08-10
Problem

A large Logseq graph accumulates unlinked mentions: notes that reference a topic without creating a link. Left alone, the graph rots through orphaned references, broken navigation, and manual cleanup sessions.

Who felt it

Me, maintaining a multi-year personal knowledge base.

Intervention

A tool that scans the graph for unlinked mentions and proposes sensible wikilinks, turning a recurring maintenance chore into a review step.

Role

Author.

Started

2026

Stack

Python.

Constraints

Logseq file formats change; false positives erode trust in the tool faster than missed links do.

Outcome

Publicly released and used in my own graph. Adoption and quantified time savings are not yet measured.

Limitations

No measured before/after time savings. The heuristics can miss or over-link.

Next step

Measure cleanup time before and after, and publish the numbers.

Evidence