šŸ‘ØšŸ¼ā€šŸ’» I Built My First Obsidian Plugin (Sort of)


Prefer to read (or listen to) this newsletter in your browser? Click here.

šŸ’” The Big Idea: You Don’t Have to Wait for Someone Else to Fix It Anymore

A few weeks ago, an Obsidian update quietly broke one of my favorite plugins.

A small tweak to the app destroyed every custom callout in my vault overnight.

As frustrating as this was, it’s not the first time something like this has happened. Right before I released LifeHQ, a plugin called Query Control was broken in the exact same way.

Last time, I had to scramble to find some kind soul in the Obsidian Discord who was willing to look at the abandoned plugin and try to update it for me.

This time, I used Claude Code and built my own replacement.

What Actually Happened

When Obsidian released version 1.3, they made a tiny change to the way that the app recognized CSS color codes. This caused the Callout Manager plugin (which I rely on heavily to create custom callout sections throughout my vault) to no longer render ANY color for those custom callouts.

The first thing I did was go to the plugin issues page to see if anyone else was having the same problem. Turns out I wasn’t alone, and someone even identified the specific cause in the initial issue report:

Seemed like it could be fixed pretty simply by changing the way that the Callout Manager plugin rendered the CSS color codes.

Unfortunately, as with a lot of community plugins, there was no response from the author for several weeks.

Can’t say as I blame them. It’s not like they’re getting paid for any of this development work.

So, with a clear understanding of the issue, I grabbed the URL for the plugin and went over to Claude.

Vibe-Coding My Obsidian Replacement Plugin

Building the replacement plugin was actually pretty easy. Claude already had access to my GitHub account, so I just pointed it at the broken plugin and asked it to fix the issue for me.

Here’s the exact prompt I used:

I want your help updating an abandoned plugin for Obsidian. The Callout Manager plugin no longer works because the new version of Obsidian requires the colors in hex codes, not RGB values. Here’s the Callout Manager plugin, please fix this and update it so that when you pick a color it gets written as a 6-digit hex code so it still works with the new Obsidian: https://github.com/eth-p/obsidian-callout-manager​

That was basically it. Claude took it from there, wrote the plugin, and published it to my GitHub account so I could install it via BRAT (a phenomenal tool for using beta plugins).

The whole thing took about 10 minutes.

But I didn’t stop there. I fixed a few other things in the plugin while I was at it, including some janky-looking buttons, some misaligned click targets, a bunch of empty space in the callout creation screen, and some small text issues. I even added a new feature that lets you export and import a code snippet with all your custom callouts, so you can save it somewhere and add them all at once into a new vault without having to create each one by hand.

The end result? My custom callouts are back šŸ™‚

But even more importantly, I’m confident that if something else breaks in my Obsidian vault, I’ll be able to fix it myself.

Even though I am not a developer and don’t know the first thing about writing code for an Obsidian plugin.

Want to Try It Yourself?

Full disclosure: I have no idea what I’m doing with GitHub. I just know that I fixed something that was broken in my vault by myself, and it felt pretty good.

If you want to see the plugin I ā€œbuiltā€ for yourself, here’s how to install it:

  1. Install and enable the BRAT plugin
  2. Go to the BRAT settings and click the Add beta plugin button
  3. Paste this URL: https://github.com/bobbleheadjoe/obsidian-callout-manager​
  4. Enable the plugin

At some point, I will figure out how to officially fork (I think that’s the term?) the plugin and document what I changed. Maybe I’ll even release it to the Obsidian Community Plugins Directory, but I didn’t do most of the work on this, and I don’t want to step on anyone’s toes.

But if you want to add a little more color to your Obsidian vault with custom callouts, now you can.

The Bottom Line: The Age of Personalized Productivity Software Is Here

For as long as software has existed, it’s been something a few people have made, and the rest of us have used. If an app didn’t do what you needed, your options were to file a feature request or find a workaround. If you didn’t want to wait an indefinite amount of time, you chose the latter — even if it meant adding unnecessary complexity to your workflow or settling for a compromised version of the tool you actually needed.

That’s the part that’s changing. The barrier to building your own tools is being removed in real-time.

A broken callout plugin is just one tiny example. But it’s a preview of something bigger: building your own software that fits the way you work instead of the other way around. Not mass-market. Not one-size-fits-all. Personalized productivity software.

You don’t need to be a developer to take advantage of this. You just need to know what you want and be able to describe it clearly.

That’s the whole skill. And if you’ve spent years building a PKM system, you’ve been practicing it the entire time.

— Mike

Practical PKM

A weekly newsletter where I help people apply values-based productivity principles and systems for personal growth, primarily using Obsidian. Subscribe if you want to make more of your notes and ideas.

Read more from Practical PKM

Prefer to read this newsletter in your browser? Click here. šŸ’” The Big Idea: What James Clear told me about how he views using AI in the writing process Last week, I was in Boise for the Craft + Commerce conference. I always love going to Craft + Commerce, but this year was extra special because I got an invite to a private mastermind that happened the day before the conference started. Part of that mastermind was a 90-minute Q&A with James Clear, author of Atomic Habits. James Clear, author...

Prefer to read (or listen to) this newsletter in your browser? Click here. šŸ’” The Big Idea: The better the tools get, the more the only thing that matters is what you bring to them. There’s a section near the start of Four Thousand Weeks that I can’t stop thinking about. Oliver Burkeman opens the book with a bold prediction made by the famous economist John Maynard Keynes. Back in 1930, Keynes stood in front of a room and told everyone that technology was about to make us roughly eight times...

Prefer to read (or listen to) this newsletter in your browser? Click here. šŸ’” The Big Idea: The Basics are Pretty Basic A few weeks ago, David & I were recording a Focused feedback episode, and the topic of a minimum viable productivity system came up. And it dawned on me that we really don’t need a whole lot to make sure that we stay focused on what really matters. A calendar. A task manager. A place for notes. That’s basically it. Every workflow, every system, every tweak and optimization...