---
title: Obsidian Sorter
type: note
status: active
proposed_folder: 300 areas/360 Dev-Ops Network Computers
proposed_folder_auto: 200 projects/Tools Software WebUI
proposed_toc: "100 Table of Contents/Areas.md → Dev-Ops & Network Computers"
proposed_tags:
  - ai
  - tool
  - project
  - architecture
  - obsidian-sorter
  - showcase
  - automation
confidence: 0.27
approved: false
proposed_for: f7ed5a17da2d
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. 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

```mermaid
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"
```

![Obsidian Sorter flow](https://maps.lab.audasmedia.com.au/obsidian-sorter/docs/diagrams/obsidian-sorter-flow.png)

## 🔗 Related Notes & Links

- **Interactive Map**: [Archify map](https://maps.lab.audasmedia.com.au/obsidian-sorter/docs/obsidian-sorter-map.html)
- **All diagrams**: [maps.lab.audasmedia.com.au/obsidian-sorter/docs/](https://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/`.