ReadingQ: building my first Obsidian plugin with Claude Code

If your first reaction is to dogpile me for using AI to create code for personal use, please hold your nose and read to the end.

(Notes: This is version 2 of this post; more details and version control in the footer.)

But first, why this plugin?

I've been organizing my reading-thinking-writing-publishing-sharing process using a content pipeline for well over 10 years. I've barely had to tweak it: resources arrive in curated inboxes, which I scan to select content for my Reading Queue; then they're read, annotated, tagged and published as Stuff I Like, with most also informing the Stuff I Think or Do precisely because I spent that time annotating them.

The tools I use to manage and move knowledge through that pipeline, however, have evolved many times: Pocket & Raindrop, delicious & diigo, ifttt & Tumblr, Obsidian & MassiveWiki, MyHub, Medium, Twitter & Facebook, LinkedIn, Bluesky & Leaflet have all played their part. Those in italics still do.

Throughout those years, the weakest link in the pipeline has remained unchanged: getting from adding something to my Reading Queue to actually reading it. This is not a tool problem, as an article I just dug up from my Reading Queue points out:

"a bookmark is a promise you make to a version of yourself who never shows up... capturing gives you the exact dopamine hit that thinking is supposed to give you, minus the work" - The Rise and Fall of the Second Brain, Chris Ng, 6 August 2026.

A few weeks ago I would never have been able to find that article - my Reading Queue was a Raindrop account, so the only pipeline content I could actually find was the stuff I'd already read, annotated and tagged.

How the RQManager plugin works

But I saw Chris' article just after creating* Reading Queue Manager, so I shared it to my Obsidian vault, not Raindrop.

( I created nothing, of course - see below).*

! Reading Queue Manager ("ReadingQ", or just plain old RQM) on my content pipeline

Here's what happens when I use RQM:

  • I was using a mobile phone, where "Share to Obsidian" gives me 3 options, one of which is is to append the URL to the bottom of my vault's daily note. I designed my daily note using Templater, so Chris' URL appeared under the last heading ("shared from apps")
    • (note: if I had been using a browser, I've configured Obsidian Web Clipper to do the same thing with a keystroke)
  • sometime later that day my plug-in was activated, either by me opening Obsidian on either of my PCs, or triggering it manually from my phone
  • it sent a chunk of Chris' article to Claude, which compares it to my project list (a semantically rich file in my Obsidian vault) and returns one or more project tags. The above article, for example, was tagged #productivity, which is how I found it as I wrote this post before actually processing it fully
    • (note: if no project can be found, it returns #tagme)
  • my plugin then turns the entire line into a Task with a deadline of tomorrow, applies the project tag(s) and the #readme tag to it, and moves it up one to the penultimate section of my daily note ("Added to readme today")

As a result, the URL appears as a task in today's daily note and:

  • tomorrow's daily note, where it appears under "to read today" (thanks to the deadline and my daily note template)
  • in a central Reading Queue thanks to the Tasks plugin, where it can be easily filtered by tag (that's how I found Chris' article)
  • in each relevant project's ToDo list (a section of each project's Map of Content), thanks to the project tag and the Tasks plugin.

What it doesn't fix

This plugin doesn't solve the underlying problem: devoting more time to reading and annotating the content on my Queue, as that's where I actually learn and generate many of my ideas.

But it's still an improvement: reading queue content now appears everywhere relevant throughout my notes, making it more likely I will find that time; and Queued content is more accessible to the rest of my content pipeline because it's auto-tagged, something I've wanted for over 10 years.

Meet Loki, RQM's creator

RQM is just a handful of markdown files in a folder on two PCs and a phone. I have not only not written a single line of that code, I haven't even read it.

RQM was written by Loki, my perpetual Claude Code agent, built as a result of Peter Kaminski's generosity. If you'd like your own AI assistant that lives in your notes, learns as you work and helps you build whatever you need, you can get started with Pete's approach for free, although I highly recommend becoming a PKAI Insider.

I call it Loki, btw, because it seems pretty powerful, and I don't entirely trust it. Loki´s code probably isn't elegant, but it runs every day, and I can change it tomorrow.

If you're a developer, this is not exactly groundbreaking work, but it's huge to me, because I'm not a developer. I've spent the last 3 decades describing applications for others to build, including websites I don't have a build budget for.

Being able to create software, even if it is just for myself, is a game-changer.

While RQM is useful to me, the true benefit of the exercise was to learnt how to improve my tools, rather than adopting and configuring someone else's.

On using Claude

Before you condemn me for using AI, remember:

  • this is personal code, a few Markdown files in a directory inside an Obsidian vault on 2 PCs and a phone: I'm not releasing it to the world, I'm not committing to maintain it, and it doesn't matter that the code isn't elegant
  • this could not exist otherwise: I'm not a developer, and I'm sick and tired of describing systems I'll never see.

All that said, I'm still conflicted about using Claude and am still thinking my way through this. Technology isn't neutral: the way AI is being concentrated into a few massive companies is the very opposite of healthy, while the environmental costs are huge. On the other hand, the outpouring of creativity and productivity from letting everyone build software could be literally world-changing.

I can't not know something about this

It's still too early to tell how these costs and benefits line up, but I do know that I can't not know something about this, and the only way of really internalising what this technology means is to kick those tyres myself. So expect more news from my own personal coalface.

I also know that if I do ever release something, it'll only ever be a proof of concept, designed to show people what the ideas in my head actually look like. If that leads to enough interest to raise funds, those funds will go to actual developers to sort out the slop.

Having said that, if anyone wants to kick RQM's tyres, ping me and I'll send you the files. Just remember that by the time you read this, my plugin will almost certainly have evolved, as RQM is the first step of many (see MyHub on the ATmosphere).


Revision Notes

This is one of this wiki's pages managed with the permanent versions pattern described in  Two wiki authors and a blogger walk into a bar…