obsidian-vault/010 inbox/Obsidian Sorter.md

title, type, status, proposed_folder, proposed_folder_auto, proposed_toc, proposed_tags, confidence, approved, proposed_for, created, tags, aliases, skills, tools

title	type	status	proposed_folder	proposed_folder_auto	proposed_toc	proposed_tags	confidence	approved	proposed_for	created	tags	aliases	skills	tools
Obsidian Sorter	note	active	300 areas/360 Dev-Ops Network Computers	200 projects/Tools Software WebUI	100 Table of Contents/Areas.md → Dev-Ops & Network Computers	ai tool project architecture obsidian-sorter showcase automation	0.27	false	f7ed5a17da2d	2026-09-24	obsidian-sorter showcase automation ai		python llm-integration systemd api-design automation	typesafe-jev systemd git rsync

Obsidian Sorter — Overview

💡 What is this project?

My notes used to pile up in whatever folder I happened to be in. This tool fixes that. I drop a note into an inbox folder, and the tool works out where it belongs and offers to file it. I tick one checkbox to say yes. Nothing moves until I do.

🌟 Key Highlights (Portfolio & Employment)

• Concept: An automated filing system for a personal knowledge vault. A model decides the destination; a human approves it. The approval gate is the point — it keeps the owner in control of a destructive operation.
• Tools & Skills Showcase: Python with no third-party libraries, a systemd user service, a decision model called over plain HTTP, and careful handling of file moves.
• Practical Value: Removes the daily friction of note organisation. Every note ends up in the right place and in the index, without manual sorting.

📐 Architecture & Flow

flowchart LR
    A["Sam writes a note"] --> B["010 inbox/"]
    B --> C{"Watcher<br/>systemd user service<br/>polls every 10s"}
    C --> D["Tier 1 - rules<br/>folder + keyword hints<br/>user tags win"]
    D -->|"confident"| F["Proposal"]
    D -->|"unsure"| E["Tier 2 - TypeSafe JEV<br/>bucket + folder + tags"]
    E --> F
    F --> G["Proposal written<br/>into the note frontmatter"]
    G --> H["Sam reviews in Obsidian"]
    H -->|"ticks approved"| I["Writer"]
    H -->|"edits folder first"| G
    I --> J["Destination folder"]
    I --> K["Table of Contents"]

    click C "https://maps.lab.audasmedia.com.au/obsidian-sorter/docs/obsidian-sorter-map.html" "View Archify Map"
    click E "https://docs.typesafe.ai" "TypeSafe JEV documentation"

🔗 Related Notes & Links

• Interactive Map: Archify map
• All diagrams: maps.lab.audasmedia.com.au/obsidian-sorter/docs/
• TypeSafe JEV: https://docs.typesafe.ai
• Design doc: docs/HANDOFF.md in the project

Notes

• Runs on .27 as a systemd user service, polling every 10 seconds.
• Costs roughly $0.0001 per note to classify.
• Type always mirrors the folder: 200 projects/, 300 areas/, 400 Personal Family/.