From: Edward <delaport@illinois.edu>
Date: Tue, 2 Jun 2026 15:49:42 +0000 (-0500)
Subject: Add simple README
X-Git-Url: https://apps.delaporte.us/gitweb/minion.git/commitdiff_plain/b7489d041b62e854e1d5495ec060c1785e15afcf?hp=3cb071d4349ce044d5e2d2a9207b25f1c419ab37

Add simple README
---

diff --git a/README.md b/README.md
index e69de29..4b25fbc 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,33 @@
+
+## Setup
+
+Clone this repository.
+Add `minion/bin` to your `PATH`.
+
+Install `Fish` shell. 
+`Fish` must be available, but does not need to be your default shell.
+
+Create a folder `~/Journal`.
+
+## Basic Usage
+
+Run `mn TOPIC DESCRIPTION` to start a new note file.
+A new file called `~/Jounal/2026/06-TOPIC-DESCRIPTION.md` will be opened in `vim`.
+
+Run `ml TOPIC` to find a previous note file from this year.
+Run `mo TOPIC` to open all `.md` files in `Journal/2026` that contain `TOPIC` in the file name. 
+
+Use `mla` and `moa` variants to search all past Journal years.
+
+Run `mh` to see `help` further available commands.
+
+## Recommended Usage
+
+- For ongoing daily work, I keep one file each month with `mn daily` and `mo 06-daily`.
+- For a random meeting, use `mn meeting topic with some key terms` to create `~/Journal/2026/06-meeting-topic-with-some-key-terms.md`
+- When too many old files match my favorite search term, I move old ones into `~/Journal/archive/2026`, where `mla` and `moa` can still find them, in a pinch.
+
+## Customizing
+
+You can modify the scripts to change the editor, and journal home folder.
+I may make use environment variables at some point to make this easier, but I haven't yet.