README file from
GithubObsidian Squire 🛡️
Your faithful note-taking companion. Squire surfaces related notes and automates file naming so you can stay in flow. Each feature is independent — use one, two, or all three.
🔗 Related Notes
Manually hunting for connections between notes interrupts your thinking. Squire automatically surfaces related notes using lexical scoring — no tagging tax, no manual cross-referencing.
Zero configuration. Related notes work immediately using TF-IDF word overlap, shared tags, and outgoing link similarity.
Sidebar view: Opens a persistent panel that auto-refreshes as you switch notes. An algorithm badge in the header shows which scorer is active (TF‑IDF / Hybrid). Click a result to open it; click Link to insert [[Title]] at your cursor.
Quick modal: Ctrl/Cmd+P → Show related notes for a one-off lookup without changing your layout. Filter by typing.
Ribbon icon: The network icon toggles the sidebar view. The sidebar's open/closed state persists across Obsidian sessions.
Match weights in Settings let you dial how much words, tags, and links influence results. Set any weight to 0 to disable that signal.
🧠 Semantic Search (Optional)
Experimental. Adds dense-embedding understanding so notes with different wording but the same meaning still surface.
Select a transformer model in Settings → Related Notes → Scorer. The model downloads on first use and is cached. The first indexing pass on a large vault may take several minutes.
When a model is active, Squire combines TF‑IDF and dense-embedding cosine similarity into a single hybrid score. Switch back to lexical-only any time by selecting Tf-idf (lexical only).
Rebuild everything in Settings clears all cached model files and computed embeddings, then re-indexes your vault from scratch.
🗂 File Management
No mental arithmetic. No manual formatting. Just pick the command and type your subject.
Right-click a note in the File Explorer and select Duplicate: Increment Last Number or Duplicate: Nest Last Number, or open the Command Palette (Ctrl/Cmd+P) and run the same commands. The new note appears in the same folder with the correctly computed prefix.
The Index separator setting defines the character between your index number and title (default -).
Increment Last Number
Finds the last number in your current note's title and increases it by 1.
1 - Biology.md→2 - .md100 - Artificial Intelligence.md→101 - .md
Nest Last Number
Adds a new sub-level after the last decimal in the note's index.
1 - Biology.md→1.1 - .md1.1 - Anatomy.md→1.1.1 - .md
[!TIP] Have a unique naming convention? Raise an issue or contribute a new transformer.
⚙️ Settings
| Setting | Feature | Description |
|---|---|---|
| Show sidebar on startup | Related Notes | Auto-open the related notes sidebar |
| Number of suggestions | Related Notes | How many results to show (1–50) |
| Scorer | Related Notes — Scoring | TF‑IDF (lexical) or hybrid semantic model |
| Word match weight | Related Notes | How strongly word similarity affects results (default: 1) |
| Tag match weight | Related Notes | How strongly shared tags affect results (default: 0.5) |
| Link match weight | Related Notes | How strongly shared outgoing links affect results (default: 0.5) |
| Rebuild everything | Related Notes — Scoring | Clear caches + re-index vault |
| Index separator | File Management | Character between number and title |
📦 Installation
- Find Squire in Obsidian Community Plugins
- Select "Add to Obsidian"
🤝 Contributing & Support
Pull requests, issues, and feedback welcome! If you have a specific naming convention or feature idea, feel free to contribute.
Funding: If Squire saves you time, hearing how it helps is greatly appreciated!