Aww: recursive retrospectives
Roberto LupiA lot has changed in Augmented Awareness. I have refactored or discarded a lot of the previous code and developed new powerful capabilities:
A new CLI and TUI for daily event tracking, implemented in Go.
MCP server support, to allow interacting with Aww using LLM chat in host applications like LM-Studio.
A recursive retrospective generator, that uses LLMs to generate daily/weekly/monthly/yearly retrospectives.
My vision of Aww is becoming reality: it keeps track of physical and mental health, provides helpful retrospectives that identify high-level trends and provides tips and suggestions for improvements.
All of this can work with local LLMs, or online ones (Gemini, OpenAI). Powerful online LLMs provide the most impressive results.
The results of the retrospectives are particularly insightful, although it heavily depends on the content of your journal.
I have been using the following format, with minor tweaks, since 2000. It is based on the following structure:
| Vault directory example | Content |
| journal | base path for the journal. I use Obsidian to write it, but any markdown editor will do. |
| journal/2025/Y2025.md | Yearly note. I use it for GTD-style Horizons of Focus planning. |
| journal/2025/01/2025-01-01.md | Daily note. I use a template that includes “Journal and events” (event tracking, populated via the Go program), “My thoughts, ideas, tasks” (free-form), “Other ideas (TIL): articles, books, links” (links to interesting articles, or kindle books, with excerpts). I track a few parameters in the frontmatter (vitals/relax/sleep/activity scores from my ringConn ring, weight and BMI, self-reported stress level). |
| journal/2025/weeks/2025-W01.md | Weekly note. I use it for my own manual retrospectives, answering the questions: “What went well?”, “What went wrong?”, “What was unexpected/surprising?”, “What did I learn?”, “What will I change/experiment with, to improve my life?”, “What I am grateful of?”, “Who did I talk to? Who did I not talk to, but should have?” |
| journal/2025/months/2025-01.md | Monthly note. I use it for my own manual retrospectives and free-form notes. |
| retrospectives | LLM-generated retrospectives |
| retrospectives/2025/r2025.md | Yearly retrospective, generated from all lower retrospectives and the yearly note. |
| retrospectives/2025/2025-01-01.md | Daily retrospective, generated from the daily note. |
| retrospectives/2025/weeks/r2025-W01.md | Weekly retrospective, generated from the daily retrospective and the weekly note. |
| retrospectives/2025/months/r2025-01.md | Monthly retrospective, generated from the weekly and daily retrospectives and the monthly note. |
You can find the source at https://github.com/robertolupi/augmented-awareness
Subscribe to my newsletter
Read articles from Roberto Lupi directly inside your inbox. Subscribe to the newsletter, and don't miss out.
Written by