82 lines
2.0 KiB
Markdown
82 lines
2.0 KiB
Markdown
---
|
|
title: Obsidian Sorter
|
|
type: note
|
|
status: active
|
|
proposed_folder: 200 projects/Tools Software WebUI
|
|
proposed_toc: "100 Table of Contents/Projects.md → Tools & Software"
|
|
proposed_tags:
|
|
- ai
|
|
- tool
|
|
- project
|
|
- architecture
|
|
- llm
|
|
- obsidian-sorter
|
|
- showcase
|
|
- automation
|
|
confidence: 0.44
|
|
approved: false
|
|
proposed_for: a830cd4e65fa
|
|
created: "2026-09-24"
|
|
tags:
|
|
- obsidian-sorter
|
|
- showcase
|
|
- automation
|
|
- ai
|
|
aliases: []
|
|
skills:
|
|
- python
|
|
- llm-integration
|
|
- systemd
|
|
- api-design
|
|
- automation
|
|
tools:
|
|
- 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.
|
|
|
|
## 🌟 Key Highlights (Portfolio & Employment)
|
|
|
|
- **Concept**: An automated filing system for a personal knowledge vault. An AI
|
|
model decides the destination; a human approves it.
|
|
- **Tools & Skills Showcase**: Python with no third-party libraries, a systemd
|
|
user service, an LLM decision API called over plain HTTP, and careful
|
|
destructive-operation safety.
|
|
- **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
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
A[Note written to inbox] --> B[Watcher polls every 10s]
|
|
B --> C{JEV model}
|
|
C -->|proposes folder + tags| D[Proposal written into note]
|
|
D --> E[Human ticks approved]
|
|
E --> B
|
|
B -->|approved| F[File to folder]
|
|
F --> G[Update Table of Contents]
|
|
|
|
click C "https://docs.typesafe.ai" "TypeSafe JEV documentation"
|
|
```
|
|
|
|
## 🔗 Related Notes & Links
|
|
|
|
- Interactive Map: [Archify Map](https://maps.lab.audasmedia.com.au/obsidian-sorter/)
|
|
- TypeSafe JEV: https://docs.typesafe.ai
|
|
|
|
## Notes
|
|
|
|
- Runs on `.27` as a systemd user service.
|
|
- Costs roughly $0.0001 per note.
|
|
- Nothing is ever filed without approval.
|