<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>michaelheap.com</title>
  <subtitle>Thoughts on leadership, code and how to fix odd edge cases in tools (not necessarily in that order)</subtitle>
  <link href="https://michaelheap.com/rss" rel="self"/>
  <link href="https://michaelheap.com"/>
  <updated>2026-01-21T09:58:37Z</updated>
  <id>https://michaelheap.com</id>
  <author>
    <name>Michael Heap</name>
    <email>[email protected]</email>
  </author>
  
  <entry>
    <title>Fix the inputs, not the outputs</title>
    <link href="https://michaelheap.com/fix-the-inputs/"/>
    <updated>2026-01-21T09:58:37Z</updated>
    <id>https://michaelheap.com/fix-the-inputs/</id>
    <content type="html">&lt;p&gt;A friend of mine is a design leader at a company with a couple of thousand people. We were recently chatting about the amount of time she was spending reviewing her team&#39;s work. It wasn&#39;t because the work was bad, but because she had no idea if the design met the needs of the project. She was spending hours trying to reverse-engineer the requirements from the final design.&lt;/p&gt;
&lt;p&gt;The reviews didn&#39;t feel good for the individual designers either. Their manager was coming in at the end of a project and scrutinizing every little decision without the full context of what the requirements were. As it turned out, the designers &lt;em&gt;also&lt;/em&gt; didn&#39;t have the full context - they knew how it started, but not how the requirements evolved over time. That information lived somewhere between the manager, the designers, and the project lead, with no clear source of truth.&lt;/p&gt;
&lt;p&gt;My friend works in a design team, but I&#39;ve seen this play out in a variety of settings. Engineers without clear product requirements. DevRel teams without clear metrics. Salespeople without a solid ideal customer profile. Anytime someone&#39;s required to fill in the blanks themselves, there&#39;s a high chance that it will lead to frustration for everyone involved.&lt;/p&gt;
&lt;h2 id=&quot;garbage-in%2C-garbage-out&quot; tabindex=&quot;-1&quot;&gt;Garbage In, Garbage Out&lt;/h2&gt;
&lt;p&gt;Every output is an echo of its inputs. If the team doesn&#39;t know what &amp;quot;good&amp;quot; looks like from the start, they have to make decisions that they&#39;re not informed enough to make. Sometimes it works out, but more often than not it results in conflict.&lt;/p&gt;
&lt;p&gt;The person reviewing the output feels that something is &amp;quot;off&amp;quot;, while the team is blindsided by feedback that could have been provided as a requirement early, before the work was done.&lt;/p&gt;
&lt;p&gt;Good requirements aren&#39;t about more documentation - they&#39;re about building a shared understanding of what you&#39;re trying to achieve.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;What problem are we solving?&lt;/li&gt;
&lt;li&gt;What does success look like?&lt;/li&gt;
&lt;li&gt;What constraints do we have?&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;By aligning on the answer to these questions early, you make it easy to evaluate the work objectively. Did it solve the problem within the constraints expressed? Yes? Excellent work! Let&#39;s ship it.&lt;/p&gt;
&lt;h2 id=&quot;a-stitch-in-time&quot; tabindex=&quot;-1&quot;&gt;A Stitch in Time&lt;/h2&gt;
&lt;p&gt;&amp;quot;But we don&#39;t have time to do such rigorous alignment work! They need this delivered yesterday!&amp;quot; I hear you, I understand, and respectfully, I disagree.&lt;/p&gt;
&lt;p&gt;You&#39;re already spending this time, and more, at the end of the project &amp;quot;catching problems&amp;quot; with the implementation. It feels productive to catch the issues, but doing it after the work is complete is both expensive and demoralizing for the team.&lt;/p&gt;
&lt;p&gt;Aligning on the inputs takes time, but it takes less time than trying to reconstruct requirements from an output. It takes less time than redoing the work because someone made a decision they didn&#39;t have enough context to make. Investing the time up front pays off in the long run. &lt;em&gt;A stitch in time saves nine.&lt;/em&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;In order to improve for good, you need to solve problems at the systems level. Fix the inputs and the outputs will fix themselves. - &lt;strong&gt;&lt;em&gt;James Clear, Atomic Habits&lt;/em&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;how-to-fix-the-inputs&quot; tabindex=&quot;-1&quot;&gt;How to Fix the Inputs&lt;/h2&gt;
&lt;p&gt;Fixing the inputs isn&#39;t hard, but it does take some concerted effort. At your next project kickoff, try asking the initial framing questions:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;What problem are we solving?&lt;/li&gt;
&lt;li&gt;What does success look like?&lt;/li&gt;
&lt;li&gt;What constraints do we have?&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Take the answers provided and write them down in a location that can be linked to from the work you do. This provides the base for your requirements doc.&lt;/p&gt;
&lt;p&gt;Over time, you&#39;ll build up a list of additional questions that are specific to your org, for example:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Is this intended for new users or for experienced users?&lt;/li&gt;
&lt;li&gt;Are they likely to interact on a small screen, or will they always be on a laptop-sized screen?&lt;/li&gt;
&lt;li&gt;There&#39;s a lot of data being processed here. Are users expecting a result within a second, a minute or an hour?&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Of course, not every requirement can be known in advance. Discovery happens through iteration and exploration. You learn what users really need, what&#39;s technically feasible, and what trade-offs actually matter by trying things out.&lt;/p&gt;
&lt;p&gt;That&#39;s normal. The problem isn&#39;t that requirements evolve, it&#39;s that the written requirements are rarely updated as the real world requirements change. The initial assumptions are treated as the &amp;quot;requirements&amp;quot; even as reality shifts. This is even worse than having no requirements at all, as the final output is then evaluated against incorrect assumptions.&lt;/p&gt;
&lt;p&gt;When requirements change, don&#39;t delete the old requirements. Instead, append to the document and make a note of the date. Then add a &amp;quot;current requirements&amp;quot; section to the top that is a synthesis of everything you know from the initial definition and the updated requirements. This is your evaluation criteria once the project is ready for review.&lt;/p&gt;
&lt;h2 id=&quot;the-real-definition-of-%22done%22&quot; tabindex=&quot;-1&quot;&gt;The Real Definition of &amp;quot;Done&amp;quot;&lt;/h2&gt;
&lt;p&gt;Everyone has a different definition of &amp;quot;done&amp;quot; depending on their context and point of view. When teams say a project is &amp;quot;done&amp;quot;, they mean that the solution is ready for review. In reality, the work is only done when everyone is aligned that this is the best possible outcome given the constraints.&lt;/p&gt;
&lt;p&gt;Before calling something complete, review everyone&#39;s understanding of the problem and the proposed solution. Ask &amp;quot;Do we still agree on what good looks like? Are the inputs still valid?&amp;quot;&lt;/p&gt;
&lt;p&gt;When inputs are solid, reviews become easier. Feedback stops becoming a surprise attack and becomes a shared evaluation against a known goal. Teams spend less time justifying their decisions and more time improving the product. &amp;quot;Done&amp;quot; stops meaning &amp;quot;I hope this is what you wanted&amp;quot; and starts meaning &amp;quot;we all understand why this is the best solution given the trade-offs&amp;quot;.&lt;/p&gt;
&lt;p&gt;So the next time you&#39;re tempted to try and reverse engineer what was required from the final output (and inevitably provide misguided feedback), pause and think about what led you to this point.&lt;/p&gt;
&lt;p&gt;Don&#39;t fix the output.&lt;/p&gt;
&lt;p&gt;Fix the input.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>When Asking is Easy (and Answering Isn&#39;t)</title>
    <link href="https://michaelheap.com/asymmetric-questions/"/>
    <updated>2026-01-14T08:34:05Z</updated>
    <id>https://michaelheap.com/asymmetric-questions/</id>
    <content type="html">&lt;p&gt;It&#39;s 4pm on a Thursday, and I&#39;m patting myself on the back that I&#39;ve managed to align multiple teams on a tricky project. The requirements document has been reviewed and approved by everyone involved, and I&#39;m excited to see what&#39;s been scoped come to life.&lt;/p&gt;
&lt;p&gt;I&#39;m about to sign off for the day when someone from our SaaS team pinged me: &amp;quot;Hey, quick question. What would it take to make this multi-tenant?&amp;quot;. It&#39;s as though the walls come crashing down around me. It&#39;s not a quick question at all - it&#39;s one that takes deep technical, historical, and organizational knowledge to unpack.&lt;/p&gt;
&lt;p&gt;I sigh as I make another cup of tea and settle in to write an essay of a response, trying to balance the need for details without it appearing as though I&#39;m trying to overwhelm them with complex explanations.&lt;/p&gt;
&lt;p&gt;Questions like this aren&#39;t malicious. They&#39;re often great questions, asked in good faith. But they reveal something important about effort - it&#39;s much easier to ask questions than to answer them.&lt;/p&gt;
&lt;h2 id=&quot;asymmetric-questions&quot; tabindex=&quot;-1&quot;&gt;Asymmetric Questions&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;An asymmetric question is one where the effort to ask is trivial compared to the effort to answer.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;This asymmetry isn&#39;t inherently bad. I&#39;d choose to work with a curious team over a disinterested team every time given a choice. But when left unchecked, these questions can lead to a high emotional load for those receiving them.&lt;/p&gt;
&lt;p&gt;I&#39;ve been the person receiving the questions, and my responses have ranged from &amp;quot;Why are they asking questions that they definitely won&#39;t understand the answer to?&amp;quot; (which was an unkind categorization on my behalf) to &amp;quot;This sucks. Weeks of alignment undone by a single question. Maybe I can pretend I didn&#39;t see it?&amp;quot; to &amp;quot;This is a good question. I should have covered this in the first place. It&#39;s going to take time, but it&#39;s worthwhile&amp;quot;.&lt;/p&gt;
&lt;p&gt;Lack of knowledge is often the driver of asymmetric questions. The person asking is often missing the context required to realize how much effort it will take to answer what appears to be a simple question.&lt;/p&gt;
&lt;p&gt;In general, the more senior or cross-functional your audience, the higher the likelihood is of one of them asking an asymmetric question. This isn&#39;t malicious - their curiosity spans domains that they&#39;re not totally familiar with.&lt;/p&gt;
&lt;p&gt;Asymmetric questions can be valuable, but they can also be distracting. If the system that the asker is operating in rewards visibility, you&#39;re going to get spontaneous questions that don&#39;t add much. They don&#39;t care as much about the answer as they do about being seen to contribute. Over time, this erodes focus and encourages reactive rather than strategic work.&lt;/p&gt;
&lt;h2 id=&quot;managing-the-imbalance&quot; tabindex=&quot;-1&quot;&gt;Managing the Imbalance&lt;/h2&gt;
&lt;p&gt;Asymmetric questions aren&#39;t malicious. They&#39;re born from curiosity, but left unchecked they can command a lot of time. It takes 30 seconds to ask a question, and 30 minutes to answer it.&lt;/p&gt;
&lt;p&gt;My rule of thumb for asymmetric questions is to spend twice as long answering a question as it took to ask it. If they spent a minute asking a question, I&#39;ll give it two minutes of thought then respond (usually to ask clarifying questions of my own). The asker&#39;s response might take 5 minutes to write, and so I&#39;ll take 10 minutes to respond.&lt;/p&gt;
&lt;p&gt;If a question takes one minute to write and will take twenty minutes to respond to, schedule a call. That&#39;s a good sign that there&#39;s something missing from either the asker&#39;s knowledge, or from your proposal itself.&lt;/p&gt;
&lt;p&gt;The goal isn&#39;t to stop people asking questions. It&#39;s to right-size your response.&lt;/p&gt;
&lt;h2 id=&quot;navigating-asymmetric-questions&quot; tabindex=&quot;-1&quot;&gt;Navigating Asymmetric Questions&lt;/h2&gt;
&lt;p&gt;The first step to navigating asymmetric questions successfully is to get past the resentment stage as quickly as possible. Even being aware of the knowledge asymmetry, I still have an initial burst of resentment every time someone asks &amp;quot;why don&#39;t we do X?&amp;quot;.&lt;/p&gt;
&lt;p&gt;The impact that their question has on the project, and on me as an individual, is huge. But I need to separate intent from impact. People don&#39;t generally ask asymmetric questions without a reason.&lt;/p&gt;
&lt;p&gt;Once you&#39;re past the initial resentment, you can engage with the asker in good faith. Many people see a question and feel like they have to answer it immediately, and in depth. This usually isn&#39;t the case.&lt;/p&gt;
&lt;h3 id=&quot;exploring-or-deciding&quot; tabindex=&quot;-1&quot;&gt;Exploring or Deciding&lt;/h3&gt;
&lt;p&gt;Questions on proposals are either &lt;em&gt;exploring&lt;/em&gt; or &lt;em&gt;deciding&lt;/em&gt;.&lt;/p&gt;
&lt;p&gt;If someone is &lt;em&gt;exploring&lt;/em&gt; an idea e.g. &amp;quot;Did we consider internationalizing the docs?&amp;quot; then you can respond with a similar level of depth. You could say &amp;quot;We did, but the return on investment for both time and cost wasn&#39;t there. I&#39;m happy to dig in more if you like.&amp;quot;&lt;/p&gt;
&lt;p&gt;If the same question is phrased slightly differently, they&#39;re looking for a &lt;em&gt;decision&lt;/em&gt;: &amp;quot;Why aren&#39;t we internationalizing the docs?&amp;quot;. My personal instinct here is to write a 10 paragraph response in the comments section of a Google doc, but that&#39;s the wrong approach. Instead, propose a follow-up with the correct audience: &amp;quot;That&#39;s a good question. A full answer will take some time to put together. Can we chat next week with a few others that were involved in the decision?&amp;quot;&lt;/p&gt;
&lt;h3 id=&quot;clarify-and-redirect&quot; tabindex=&quot;-1&quot;&gt;Clarify and Redirect&lt;/h3&gt;
&lt;p&gt;If the question is open-ended, don&#39;t try to answer every potential question. Here&#39;s one question that I had recently:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Why don&#39;t we provide a hosted version of {Dependency X}?&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Instead of diving in, I asked a clarifying question to narrow the scope: &amp;quot;There a couple of reasons. Are you asking about technical, cost or market reasons?&amp;quot;. The author came back with &amp;quot;market&amp;quot; and I explained that a hosted version would be well received by the market, but the technical implications (single tenant dependency) meant that the cost of providing a service (COGS) was too high for it to be a viable option for us.&lt;/p&gt;
&lt;p&gt;Asking questions turns what sounds like a demand into a conversation. Either the asker wants to really dig in and you can have a fruitful conversation, or (as I&#39;ve experienced many times) they just don&#39;t respond at all and you can forget about the question entirely.&lt;/p&gt;
&lt;h2 id=&quot;answer-with-intention&quot; tabindex=&quot;-1&quot;&gt;Answer with Intention&lt;/h2&gt;
&lt;p&gt;Asymmetric questions are inevitable in collaborative work, especially as scope and seniority increases. By clarifying the questions and matching your effort to their intent you can keep projects moving without letting &amp;quot;one quick question&amp;quot; derail weeks of progress.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Visibility is Velocity</title>
    <link href="https://michaelheap.com/visibility-is-velocity/"/>
    <updated>2026-01-07T11:29:57Z</updated>
    <id>https://michaelheap.com/visibility-is-velocity/</id>
    <content type="html">&lt;p&gt;Once upon a time, I worked with a Product Manager, Bob. Bob&#39;s team worked with incoming data pipelines, and transformed and augmented a variety of disparate data sources in to a consistent data model. It was a tough job, as you didn&#39;t actually know what data you were going to receive from our providers until it arrived.&lt;/p&gt;
&lt;p&gt;Bob’s team also had a reputation for being &lt;em&gt;slow&lt;/em&gt;. On average, onboarding a new data source took about three months. When the work shipped, though, it was excellent: reliable, well-instrumented, and easy to maintain.&lt;/p&gt;
&lt;p&gt;But when they shipped, they didn&#39;t get any accolades. The team heard &amp;quot;Finally! Why did it take so long?&amp;quot;. Worse, they heard &amp;quot;I wish you&#39;d have warned us - we haven&#39;t implemented the new data source in the billing system&amp;quot;. So not only did the project &lt;em&gt;feel&lt;/em&gt; late, the business couldn’t even use what had been delivered.&lt;/p&gt;
&lt;p&gt;A few months later, Bob was no longer with the company. The feedback was that he “wasn’t compatible with how the business needed to operate.” We hired Alice as his replacement.&lt;/p&gt;
&lt;p&gt;The perceived change was immediate. Alice shipped something in her first two weeks. People were impressed. It didn’t even seem plausible that Bob’s team could ship &lt;em&gt;anything&lt;/em&gt; in two weeks, let alone within two weeks of a new PM starting.&lt;/p&gt;
&lt;p&gt;But Alice didn’t &lt;em&gt;actually&lt;/em&gt; make the team faster. New data sources still took three months to fully integrate. The work was the same. The complexity was the same. What changed was that progress became visible.&lt;/p&gt;
&lt;p&gt;And suddenly, everyone believed the team had become fast.&lt;/p&gt;
&lt;h2 id=&quot;the-dangers-of-silence&quot; tabindex=&quot;-1&quot;&gt;The Dangers of Silence&lt;/h2&gt;
&lt;p&gt;Humans hate ambiguity. When there’s no signal, people invent their own story.&lt;/p&gt;
&lt;p&gt;Bob&#39;s lack of updates created its own narrative: the work had stalled, or it wasn’t a priority. The project lost momentum. Other teams postponed their related work. Leaders delayed decisions tied to the project. Everyone just kind of &amp;quot;forgot&amp;quot; about the ongoing work.&lt;/p&gt;
&lt;p&gt;The lack of communication usually comes from a good place:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“I didn’t want to distract people until I had something solid.”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;But updates aren&#39;t a distraction. Surprises are. And surprises are expensive for everyone.&lt;/p&gt;
&lt;p&gt;Each and every time I&#39;ve found myself surprising an executive, I&#39;ve ended up on calls where they&#39;re trying to figure out what&#39;s going on. Those calls take a &lt;em&gt;lot&lt;/em&gt; of time.&lt;/p&gt;
&lt;p&gt;We need to re-establish context for those that aren&#39;t deep in the project, then explain what&#39;s happening and why. The conversation inevitably turns to re-litigation of a decision that was already made.&lt;/p&gt;
&lt;p&gt;Before you know it, the engineering team is frustrated that we&#39;re revisiting old decisions and the execs are frustrated that things are taking even longer. Surprises don&#39;t serve anyone.&lt;/p&gt;
&lt;h2 id=&quot;the-power-of-updates&quot; tabindex=&quot;-1&quot;&gt;The Power of Updates&lt;/h2&gt;
&lt;p&gt;Sending regular updates doesn&#39;t make you go any faster - in fact, it slows you down slightly as writing the updates takes time. You don&#39;t want them to be a torrent of useless information (&amp;quot;We added 14 new tests and added support for the FlubJam&amp;quot;). Instead, focus on what&#39;s useful (&amp;quot;We added tests to ensure that URL mapping works consistently, and integrated FlubJam so that the billing team can get started with their work&amp;quot;).&lt;/p&gt;
&lt;p&gt;These small, regular updates build trust and predictability for your audience. They know what&#39;s happening, and that the project is still on track. And if there &lt;em&gt;is&lt;/em&gt; something that isn&#39;t quite right, these regular updates allows people to raise concerns, build alignment and course correct while the cost of doing so is cheap.&lt;/p&gt;
&lt;h2 id=&quot;how-to-ship-incrementally&quot; tabindex=&quot;-1&quot;&gt;How to Ship Incrementally&lt;/h2&gt;
&lt;p&gt;Let&#39;s go back to Bob and Alice. Alice didn’t deliver results any faster. She just made progress visible.&lt;/p&gt;
&lt;p&gt;Instead of waiting for everything to be solid, she shared updates like these:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Week 2: Great news! We&#39;ve connected to the third party system. Here&#39;s a video of us ingesting a piece of data (no mapping, no augmentation)&lt;/li&gt;
&lt;li&gt;Week 4: We&#39;ve figured out what data is available. Here&#39;s a link to our proposed data mapping, and a demo video with the mapping added&lt;/li&gt;
&lt;li&gt;Week 6: The pipeline is running well, and we&#39;ve managed to add some augmentations. Here&#39;s a video of URL extraction from text working. Look how it augments the data with the page title from the URL&lt;/li&gt;
&lt;li&gt;Week 8: Slow progress this week. We realised that the data isn&#39;t guaranteed to arrive in order, so it turns out that we were missing some data. We&#39;re reworking our pipeline to use the deduplication service so that we don&#39;t have to rely on timestamps. I&#39;m still optimistic that we&#39;ll be done next month&lt;/li&gt;
&lt;li&gt;Week 10: All solved! I&#39;ve shared the data size/volume information with the billing team so that they can load it into the rate card system. We&#39;re working on additional test cases to give us confidence that we haven&#39;t missed anything.&lt;/li&gt;
&lt;li&gt;Week 12: Tada! The project is done. Here&#39;s a list of sample configurations and test cases that we run. Thank you for all the feedback along the way.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;We still couldn&#39;t ship the new data source to customers until week 12, but all of the stakeholders were clear what was happening every step of the way.&lt;/p&gt;
&lt;p&gt;Compare that to Bob&#39;s updates:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Week 12: The integration is complete. Here’s the final implementation - let me know if you have feedback.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The engineering team did the same work on the same timeline, but the leadership team had a &lt;em&gt;very different perception&lt;/em&gt;.&lt;/p&gt;
&lt;p&gt;Alice wasn’t seen as faster because she did more. She was seen as faster because progress showed up continuously. Risks were surfaced early, course corrections happened when needed, and no one was surprised at the end.&lt;/p&gt;
&lt;p&gt;Your updates don’t need to be long. Fifteen minutes to produce. Two minutes to consume. That&#39;s all it takes.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Bulk unsubscribe in Gmail</title>
    <link href="https://michaelheap.com/gmail-unsubscribe/"/>
    <updated>2026-01-06T10:23:42Z</updated>
    <id>https://michaelheap.com/gmail-unsubscribe/</id>
    <content type="html">&lt;p&gt;Back in 2021 I added an idea to &lt;a href=&quot;https://michaelheap.com/ideas&quot;&gt;/ideas&lt;/a&gt; that would scan my email inbox and provide a single page containing unsubscribe links that have been scraped from emails. Here was the proposal:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;A UI that reads all emails in a folder and shows all emails with an &lt;code&gt;unsubscribe&lt;/code&gt; link.&lt;br /&gt;
Provide a way to group by sender / subject / unsubscribe URL&lt;br /&gt;
I&#39;d like to be able to choose which folder this runs in (minimum Inbox + Trash, but ideally any folder/label)&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Today I learned that Google have built this themselves. In your inbox, click on &lt;code&gt;More&lt;/code&gt; in the sidebar and then choose &lt;code&gt;Manage subscriptions&lt;/code&gt;. You&#39;ll see a screen that shows you email volume from each sender and allows you to unsubscribe with a single click.&lt;/p&gt;
&lt;div class=&quot;image-wrapper &quot;&gt;&lt;picture&gt; &lt;source class=&quot;&quot; type=&quot;image/webp&quot; srcset=&quot;https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-320.webp 320w, https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-640.webp 640w, https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-960.webp 960w, https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-1200.webp 1200w&quot; sizes=&quot;(max-width: 320px) 320px, (max-width: 640px) 640px, (max-width: 960px) 960px, (max-width: 1200px) 1200px, 100vw&quot; /&gt; &lt;img class=&quot;&quot; alt=&quot;Gmail Manage Subscriptions page screenshot&quot; src=&quot;https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-1200.jpeg&quot; sizes=&quot;(max-width: 320px) 320px, (max-width: 640px) 640px, (max-width: 960px) 960px, (max-width: 1200px) 1200px, 100vw&quot; srcset=&quot;https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-320.jpeg 320w, https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-640.jpeg 640w, https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-960.jpeg 960w, https://michaelheap.com/images/gmail-unsubscribe/manage-subscriptions.png/TLIW-f1pvP-1200.jpeg 1200w&quot; width=&quot;1200&quot; height=&quot;592&quot; /&gt; &lt;/picture&gt;&lt;/div&gt;
&lt;p&gt;Now, I need to go and unsubscribe from all of these Kickstarter platform emails that I always delete without reading...&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Building `listentotaxman-cli` with OpenCode + Claude Sonnet 4.5</title>
    <link href="https://michaelheap.com/listentotaxman-cli/"/>
    <updated>2026-01-05T16:01:31Z</updated>
    <id>https://michaelheap.com/listentotaxman-cli/</id>
    <content type="html">&lt;p&gt;If you&#39;ve ever needed to calculate tax in the UK, you&#39;ve probably landed on &lt;a href=&quot;https://listentotaxman.com/&quot;&gt;https://listentotaxman.com/&lt;/a&gt;. My main use case is comparing two sets of numbers - sometimes it&#39;s base salary, sometimes it&#39;s to see what happens if I change a pension contribution %.&lt;/p&gt;
&lt;p&gt;The website is ok, but I wanted something I could script. So this morning, I &lt;a href=&quot;https://github.com/mheap/listentotaxman-cli?tab=readme-ov-file#usage&quot;&gt;wrapped their API in a CLI&lt;/a&gt;. Or rather, I asked Copilot / Claude Sonnet 4.5 to wrap their API while I did some other work.&lt;/p&gt;
&lt;p&gt;This idea has been on my &lt;a href=&quot;https://michaelheap.com/ideas&quot;&gt;/ideas&lt;/a&gt; page since September 2021, and I&#39;ve never taken the time to build it out. Occasionally I&#39;ll use the website and remember that I wanted to build a CLI but then I solve my immediate problem and move on.&lt;/p&gt;
&lt;p&gt;Today, I decided that this was a nice, bounded problem that I could use to test out &lt;code&gt;OpenCode&lt;/code&gt;, which was recommended to me over the weekend as a vendor neutral Claude Code replacement.&lt;/p&gt;
&lt;h2 id=&quot;building-with-opencode-%2B-copilot&quot; tabindex=&quot;-1&quot;&gt;Building with OpenCode + Copilot&lt;/h2&gt;
&lt;p&gt;Here&#39;s the transcript of the conversation I had with OpenCode. I&#39;ve skipped over some of the clarifying questions that were inconsequential (e.g. when it asked if responses should be cached, which ASCII table library I prefer etc). I&#39;ve added a &lt;code&gt;clarification&lt;/code&gt; section when it asked good questions, and &lt;code&gt;insight&lt;/code&gt; for when I was pleasantly surprised when the LLM reminded me about actions that I needed to take.&lt;/p&gt;
&lt;p&gt;As with when I was building &lt;a href=&quot;https://michaelheap.com/gh-saved-issues/&quot;&gt;gh-saved-issues&lt;/a&gt; I did some initial exploration so that I could provide &lt;code&gt;curl&lt;/code&gt; commands to get the project started:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;You are building a Cobra based Golang CLI for &lt;a href=&quot;https://listentotaxman.com/&quot;&gt;https://listentotaxman.com/&lt;/a&gt;. A sample curl request for calling the API is:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;curl &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;https://listentotaxman.com/ws/tax/index.js.php&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  --data-raw &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;{&quot;response&quot;:&quot;json&quot;,&quot;year&quot;:&quot;2025&quot;,&quot;taxregion&quot;:&quot;uk&quot;,&quot;age&quot;:&quot;0&quot;,&quot;pension&quot;:&quot;3%&quot;,&quot;time&quot;:&quot;1&quot;,&quot;grosswage&quot;:100000}&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;Build a CLI that can be invoked as:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;listentotaxman check --year 2025 --region uk --age 0 --pension 3% --grosswage 100000 --student-loan postgraduate --extra 999 --tax-code K12&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;The --tax-code flag should be passed as &amp;quot;taxcode&amp;quot; in the API request&lt;br /&gt;
The --student-loan flag should be passed as &amp;quot;plan&amp;quot; in the API request&lt;br /&gt;
The --region flag should be passed as &amp;quot;taxregion&amp;quot; in the API request&lt;/p&gt;
&lt;p&gt;Year should default to the current year (e.g. 2026) if today&#39;s date is after the fifth of april. Otherwise it should default to the previous year.&lt;/p&gt;
&lt;p&gt;--tax-region should default to &amp;quot;uk&amp;quot;&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;The LLM one-shot this pretty well. I could run &lt;code&gt;listentotaxman check&lt;/code&gt; and see the output:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;╔══════════════════════════════════════════════╗&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Tax Calculation for 2025 (UK) - Yearly       ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;╠══════════════════════════════════════════════╣&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Gross Salary                     £100,000.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Taxable Pay                       £97,129.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Tax Paid                          £31,311.60 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ National Insurance                 £4,010.60 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Student Loan                       £4,740.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Pension (You)                      £3,000.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Net Pay                           £56,937.80 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;╠══════════════════════════════════════════════╣&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Employer&#39;s NI                     £14,250.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Pension (HMRC)                     £2,000.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;║ Total Cost                       £116,250.00 ║&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: undefined&quot;&gt;╚══════════════════════════════════════════════╝&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;One of the things I liked about the website is the ability to see these figures for a specific time period:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Add a --period flag that defaults to &amp;quot;yearly&amp;quot;. Other possible options are &amp;quot;monthly&amp;quot; &amp;quot;weekly&amp;quot; &amp;quot;daily&amp;quot; &amp;quot;hourly&amp;quot;. Take the &amp;quot;yearly&amp;quot; values and divide by the 12 (monthly), 52 (weekly) or 365 (daily) or 2920 (hourly)&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Did you spot my mistake? The LLM did:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
❓ Clarification
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Question: Is 2920 correct for hourly? This assumes 8-hour workdays. Some alternatives:&lt;/p&gt;
&lt;p&gt;2080 hours (40 hours/week × 52 weeks) - standard US calculation&lt;br /&gt;
1820 hours (typical UK full-time: 37.5 hours/week × 52 weeks - 5 weeks holiday)&lt;br /&gt;
2920 hours (365 × 8 hours) - your specified value&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;I opted to use 2080 hours, assuming that I get paid for my lunchtime too.&lt;/p&gt;
&lt;p&gt;At this point the CLI was working well, but there were some formatting issues due to the recent changes:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Alignment is off in the header:&lt;/p&gt;
&lt;p&gt;══════════════════════════════════════════════╗&lt;br /&gt;
║ Tax Calculation for 2025 (UK) - Monthly║&lt;br /&gt;
╠══════════════════════════════════════════════╣&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;With the basic usage working, it was time to add the &lt;code&gt;compare&lt;/code&gt; command that the UI doesn&#39;t provide. The trickiest thing to figure out here was how to accept groups of information.&lt;/p&gt;
&lt;p&gt;I ended up accepting the pattern &lt;code&gt;--option &amp;lt;NAME&amp;gt; --flags go --here&lt;/code&gt;, where any flags provided after one &lt;code&gt;--option&lt;/code&gt; value, but before another are treated as one set of configuration:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Now add a new &lt;code&gt;listentotaxman compare&lt;/code&gt; command. Accept all flags from &lt;code&gt;listentotaxman check&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;Each flag can be provided multiple times. Each group of inputs should be preceeded by an &lt;code&gt;--option&lt;/code&gt; flag e.g.:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;listentotaxman compare --option job1 --pension 3% --grosswage 10 --option job2 --grosswage 1000 --pension 10%&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Once the command was built, I ran &lt;code&gt;listentotaxman compare --help&lt;/code&gt; to see how to use it, but the help screen was useless:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Improve the --help output. The following is not useful:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;Error: no options specified &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;use --option to define each scenario&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;Usage:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;listentotaxman compare&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;Flags:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;-h, --help &lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;help&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; compare&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;Error: no options specified &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;use --option to define each scenario&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;The LLM updated the &lt;code&gt;--help&lt;/code&gt; command with &lt;a href=&quot;https://github.com/mheap/listentotaxman-cli/blob/32e8fd38ec1e16689537196b405e6ff08c38e007/cmd/compare.go#L48-L72&quot;&gt;many useful examples&lt;/a&gt;:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;listentotaxman compare &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  --option &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Current Job&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; --income 100000 --pension 3% &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  --option &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;New Offer&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; --income 120000 --pension 5%&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;The CLI did everything I needed at this point. Everything that I did next was just polishing the experience:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Format numbers using the correct locale e.g. 100,000 rather than 100000&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;I realsied that I only provided sample API calls, and we should support everything the UI does. I&#39;ve removed the HTML from the following prompt, but assume that I pasted in the whole HTML form from the UI:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Here is the HTML definition for the inputs available on the website. Which CLI flags are we missing?&lt;/p&gt;
&lt;p&gt;...snip...&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;It was interesting for me to see the LLM match the UI properties to the form:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
👀 Insight
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Implemented ✅&lt;br /&gt;
--year - Tax year&lt;br /&gt;
--region - Tax region (uk, scotland, wales, ni)&lt;br /&gt;
--grosswage - Salary amount&lt;br /&gt;
--pension - Pension contribution (£ or %)&lt;br /&gt;
--student-loan (maps to plan) - Student loan plan&lt;br /&gt;
--age - Age selection&lt;br /&gt;
--tax-code (maps to code) - Tax code&lt;br /&gt;
--extra (maps to add) - Additional allowances/deductions&lt;br /&gt;
Missing Flags 🔴&lt;br /&gt;
Based on the HTML form, we&#39;re missing these inputs:&lt;/p&gt;
&lt;p&gt;--married (checkbox: married)&lt;/p&gt;
&lt;p&gt;Boolean flag for married status&lt;br /&gt;
Affects marriage allowance calculations&lt;br /&gt;
--blind (checkbox: blind)&lt;/p&gt;
&lt;p&gt;Boolean flag for blind person&#39;s allowance&lt;br /&gt;
Additional tax-free allowance for registered blind persons&lt;br /&gt;
--no-ni or --exempt-ni** (checkbox: exNI)&lt;/p&gt;
&lt;p&gt;Boolean flag for &amp;quot;I pay no NI&amp;quot;&lt;br /&gt;
For people exempt from National Insurance&lt;br /&gt;
--partner-wage (input: partnerGrossWage)&lt;/p&gt;
&lt;p&gt;Partner&#39;s gross wage for marriage allowance calculations&lt;br /&gt;
Only relevant when married flag is set&lt;br /&gt;
Affects transferable marriage allowance&lt;br /&gt;
--time - Input frequency selector&lt;/p&gt;
&lt;p&gt;Currently we only accept yearly amounts&lt;br /&gt;
Website supports: year, month, 4 weeks, 2 weeks, week, day, hour&lt;br /&gt;
Note: This is an INPUT multiplier, different from our --period OUTPUT divisor&lt;br /&gt;
Additional Observations&lt;br /&gt;
Student Loan Plans&lt;br /&gt;
We support:&lt;/p&gt;
&lt;p&gt;✅ plan1&lt;br /&gt;
✅ plan2&lt;br /&gt;
✅ postgraduate&lt;br /&gt;
We&#39;re missing:&lt;/p&gt;
&lt;p&gt;🔴 plan4 - Plan 4 (for students from Scotland)&lt;br /&gt;
🔴 scottish - Scottish student loan&lt;br /&gt;
Age Values&lt;br /&gt;
Current implementation uses string values like &amp;quot;0&amp;quot;, &amp;quot;1&amp;quot;, &amp;quot;2&amp;quot;, &amp;quot;3&amp;quot;&lt;/p&gt;
&lt;p&gt;Website uses:&lt;/p&gt;
&lt;p&gt;0 - under 65 ✅&lt;br /&gt;
3 - female 60-65 (historical, likely for older tax years) 🔴&lt;br /&gt;
1 - 65-74 ✅&lt;br /&gt;
2 - over 75 ✅&lt;br /&gt;
We&#39;re mostly correct but missing the &amp;quot;female 60-65&amp;quot; option.&lt;/p&gt;
&lt;p&gt;Region Values&lt;br /&gt;
Our values match except:&lt;/p&gt;
&lt;p&gt;We use: uk, scotland, wales, ni ✅&lt;br /&gt;
Website uses: uk, scotland, eng, wales, ni&lt;br /&gt;
Minor difference: We don&#39;t have eng (England) as distinct from uk 🟡&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;I had the LLM implement all of the above flags and options (and add them to &lt;code&gt;--help&lt;/code&gt;), then continued to polish the experience:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Rename --grosswage to --income&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Finally, it was time to release. I knew I wanted to use GitHub Actions and &lt;code&gt;goreleaser&lt;/code&gt;:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;I want to build and release this tool with github actions and goreleaser. Build a plan to add this CI/CD setup&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;The LLM wanted to do so much more! It suggested enabling CodeQL, dependabot, Homebrew support and Docker builds.&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
❓ Clarification
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Please answer the questions above, and I&#39;ll create:&lt;/p&gt;
&lt;p&gt;Minimal setup (if you want quick start):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;.goreleaser.yml with basic config&lt;/li&gt;
&lt;li&gt;.github/workflows/release.yml for releases&lt;/li&gt;
&lt;li&gt;.github/workflows/ci.yml for testing&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Full-featured setup (if you want everything):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;All workflows (release, CI, CodeQL, dependabot)&lt;/li&gt;
&lt;li&gt;Homebrew tap support&lt;/li&gt;
&lt;li&gt;Docker image builds&lt;/li&gt;
&lt;li&gt;Comprehensive documentation&lt;/li&gt;
&lt;li&gt;Security scanning&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Which approach do you prefer? And please let me know your answers to the questions above!&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;I chose an option that it didn&#39;t give me: the minimal setup, but with Homebrew/Docker support too.&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Option 3: Minimal setup, but with Homebrew / Docker support&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;This is when the LLM surprised me. In addition to generating all of the workflows, it succinctly explained which secrets I needed to add to my repository, and how to find those values:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
👀 Insight
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;🔧 Manual Setup Steps Checklist&lt;br /&gt;
Before you can release, complete these manual steps:&lt;/p&gt;
&lt;p&gt;✅ Step 1: Create Docker Hub Access Token&lt;br /&gt;
Go to &lt;a href=&quot;https://hub.docker.com/settings/security&quot;&gt;https://hub.docker.com/settings/security&lt;/a&gt;&lt;br /&gt;
Click &amp;quot;New Access Token&amp;quot;&lt;br /&gt;
Description: &amp;quot;GoReleaser CI/CD&amp;quot;&lt;br /&gt;
Access permissions: &amp;quot;Read, Write, Delete&amp;quot;&lt;br /&gt;
Generate and COPY the token (shown only once)&lt;/p&gt;
&lt;p&gt;✅ Step 2: Create GitHub Personal Access Token&lt;br /&gt;
Go to &lt;a href=&quot;https://github.com/settings/tokens&quot;&gt;https://github.com/settings/tokens&lt;/a&gt;&lt;br /&gt;
Click &amp;quot;Generate new token (classic)&amp;quot;&lt;br /&gt;
Name: &amp;quot;GoReleaser Homebrew Tap&amp;quot;&lt;br /&gt;
Expiration: No expiration (or as preferred)&lt;br /&gt;
Scopes: Check repo (all sub-scopes)&lt;br /&gt;
Generate and COPY the token&lt;/p&gt;
&lt;p&gt;✅ Step 3: Add Secrets to GitHub Repository&lt;br /&gt;
Navigate to: &lt;a href=&quot;https://github.com/mheap/listentotaxman-cli/settings/secrets/actions&quot;&gt;https://github.com/mheap/listentotaxman-cli/settings/secrets/actions&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Click &amp;quot;New repository secret&amp;quot; for each:&lt;/p&gt;
&lt;p&gt;Secret 1: GH_PAT&lt;/p&gt;
&lt;p&gt;Name: GH_PAT&lt;br /&gt;
Value: (GitHub PAT from Step 2)&lt;br /&gt;
Secret 2: DOCKERHUB_USERNAME&lt;/p&gt;
&lt;p&gt;Name: DOCKERHUB_USERNAME&lt;br /&gt;
Value: mheap&lt;br /&gt;
Secret 3: DOCKERHUB_TOKEN&lt;/p&gt;
&lt;p&gt;Name: DOCKERHUB_TOKEN&lt;br /&gt;
Value: (Docker Hub token from Step 1)&lt;/p&gt;
&lt;p&gt;✅ Step 4: Configure GitHub Actions Permissions&lt;br /&gt;
Go to: &lt;a href=&quot;https://github.com/mheap/listentotaxman-cli/settings/actions&quot;&gt;https://github.com/mheap/listentotaxman-cli/settings/actions&lt;/a&gt;&lt;br /&gt;
Under &amp;quot;Workflow permissions&amp;quot;:&lt;br /&gt;
Select &amp;quot;Read and write permissions&amp;quot;&lt;br /&gt;
Check &amp;quot;Allow GitHub Actions to create and approve pull requests&amp;quot;&lt;br /&gt;
Click &amp;quot;Save&amp;quot;&lt;/p&gt;
&lt;p&gt;✅ Step 5: Verify Homebrew Tap Repository&lt;br /&gt;
Confirm &lt;a href=&quot;https://github.com/mheap/homebrew-tap&quot;&gt;https://github.com/mheap/homebrew-tap&lt;/a&gt; exists and is:&lt;/p&gt;
&lt;p&gt;Public&lt;br /&gt;
Empty (or has minimal content - GoReleaser will manage it)&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;I didn&#39;t like that I had to provide permissions via settings. I want them declared in the workflow instead:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Update the GitHub Actions workflows to set permissions explicitly&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;And finally, it wouldn&#39;t be a GitHub Actions implementation unless the first build failed. The LLM somehow generated a version 2 configuration file for &lt;code&gt;goreleaser&lt;/code&gt; while using version 1 in CI. I pasted the error in and it fixed it with no intervention from me:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;only configurations files on version: 1 are supported, yours is version: 2, please update your configuration&lt;br /&gt;
Error: The process &#39;/opt/hostedtoolcache/goreleaser-action/1.26.2/x64/goreleaser&#39; failed with exit code 1&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;I pushed these changes to the repo, tagged a new release and watched as the &lt;code&gt;listentotaxman&lt;/code&gt; CLI came alive! I ran &lt;code&gt;brew install mheap/tap/listentotaxman&lt;/code&gt; on my local machine and now I can compare tax implications as much as I want 😁.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Electron Node module version</title>
    <link href="https://michaelheap.com/electron-node-module-version/"/>
    <updated>2025-12-27T17:11:26Z</updated>
    <id>https://michaelheap.com/electron-node-module-version/</id>
    <content type="html">&lt;p&gt;I&#39;ve been building an Electron app for the first time. It was all going well until I tried to use a dependency that involved native components. When I tried to run the app, I got an error that &lt;code&gt;[...] was compiled against a different Node.js version&lt;/code&gt;:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;Error occurred &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; handler &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;tasks:fetch&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;: Error: The module &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;/private/tmp/electron-demo/node_modules/better-sqlite3/build/Release/better_sqlite3.node&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;was compiled against a different Node.js version using&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;NODE_MODULE_VERSION 137. This version of Node.js requires&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;NODE_MODULE_VERSION 140. Please try re-compiling or re-installing&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;the module &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;for instance, using &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;`&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;npm rebuild&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;`&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; or &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;`&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;npm install&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;`&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;It turns out that the node.js and Electron ABIs are not compatible (see the &lt;a href=&quot;https://github.com/nodejs/node/blob/main/doc/abi_version_registry.json&quot;&gt;compatibility matrix&lt;/a&gt;), and any native code needs to be compiled specifically for Electron.&lt;/p&gt;
&lt;p&gt;To solve the issue above, you have to rebuild native modules for Electron using &lt;code&gt;@electron/rebuild&lt;/code&gt;:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;npm install --save-dev @electron/rebuild&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;./node_modules/.bin/electron-rebuild&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;Then &lt;code&gt;npm start&lt;/code&gt; and everything works.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;⚠️ You&#39;ll need to re-run &lt;code&gt;electron-rebuild&lt;/code&gt; after every &lt;code&gt;npm install&lt;/code&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;reproduction-case&quot; tabindex=&quot;-1&quot;&gt;Reproduction case&lt;/h2&gt;
&lt;p&gt;If you&#39;re looking for a simple reproduction case:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;git clone https://github.com/mheap/electron-build-sample&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;cd&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; electron-build-sample&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;npm install&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;npm start &lt;/span&gt;&lt;span style=&quot;color: #616E88&quot;&gt;# You&#39;ll get an error here&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;Rebuild the native modules and try again:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;./node_modules/.bin/electron-rebuild&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;npm start&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;You&#39;ll see a task that says &amp;quot;Do the thing&amp;quot;.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Toolsmiths melt snowflakes</title>
    <link href="https://michaelheap.com/toolsmiths-melt-snowflakes/"/>
    <updated>2025-12-17T09:30:00Z</updated>
    <id>https://michaelheap.com/toolsmiths-melt-snowflakes/</id>
    <content type="html">&lt;p&gt;Every company has snowflakes. Each one unique, delicate, and guaranteed to melt under pressure.&lt;/p&gt;
&lt;p&gt;They accumulate quietly: the one-off script someone runs before every deploy, the spreadsheet with its own arcane formula logic, the onboarding flow that requires five Slack DMs to complete. Over time, those snowflake processes pile up into a blizzard of operational friction.&lt;/p&gt;
&lt;p&gt;Toolsmiths are the ones who melt them.&lt;/p&gt;
&lt;p&gt;They’re not the loudest people in the room. You won’t see them pitching product roadmaps or leading all-hands. But they build the quiet infrastructure that keeps a company from freezing in place. A toolsmith sees repetition and decides it shouldn’t exist. They build a small script, an automation, a workflow, and suddenly something that was fragile becomes reusable. That’s the kind of leverage that scales an organization, yet it’s often invisible.&lt;/p&gt;
&lt;h2 id=&quot;from-infrastructure-to-everywhere&quot; tabindex=&quot;-1&quot;&gt;From Infrastructure to Everywhere&lt;/h2&gt;
&lt;p&gt;The idea of codifying process isn’t new. The DevOps movement was built on it. Chef, Ansible, and later Terraform turned one-off, bespoke configurations into repeatable, version-controlled artifacts. Infrastructure stopped being artisanal; it became declarative.&lt;/p&gt;
&lt;p&gt;But somewhere along the way, the rest of the business got left behind. Marketing teams still handcraft campaigns in silos. Support teams dig through logs by memory. BI teams spend days reconciling slightly different versions of the truth in spreadsheets. Every team has its own snowflakes, and very few have the tools (or the permission) to melt them.&lt;/p&gt;
&lt;p&gt;If your business isn’t like this, congratulations! You’ve invested in systems and they’re paying off. Sadly though, many businesses haven’t (engineering teams included) and they’re just one typo away from a meltdown.&lt;/p&gt;
&lt;h2 id=&quot;the-small-tools-that-matter&quot; tabindex=&quot;-1&quot;&gt;The Small Tools That Matter&lt;/h2&gt;
&lt;p&gt;A few years ago, I built a simple CLI tool for GitHub. Its only job was to &lt;a href=&quot;https://github.com/mheap/pin-github-action&quot;&gt;pin every GitHub Action to a specific SHA&lt;/a&gt;. That’s it. It took an afternoon to write.&lt;/p&gt;
&lt;p&gt;Before that, every repository had workflows that pulled the latest version of an action. This was fine, until one day an upstream change broke half our builds. The “fix” was manual: open each repo, edit the workflow to pin to a specific commit hash, commit, push. Tedious, error-prone, and repeated by multiple teams.&lt;/p&gt;
&lt;p&gt;So I wrote a CLI that scanned all repos in our org and pinned each action automatically. One run. Hundreds of snowflakes gone.&lt;/p&gt;
&lt;p&gt;No one outside engineering noticed. But internally, it saved dozens of hours and reduced risk every time someone added a new workflow.&lt;/p&gt;
&lt;h2 id=&quot;toolsmiths-aren%E2%80%99t-just-developers&quot; tabindex=&quot;-1&quot;&gt;Toolsmiths Aren’t Just Developers&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Toolsmithing is a mindset, not a job title.&lt;/strong&gt; It’s what happens when someone sees a messy process and refuses to accept it as normal.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In BI, it’s the analyst who turns scattered spreadsheets into a shared dashboard that updates automatically.&lt;/li&gt;
&lt;li&gt;In Support, it’s the agent who builds a small search interface over logs so others don’t need to memorize file paths or grep commands.&lt;/li&gt;
&lt;li&gt;In Partnerships, it’s the manager who realises that every customer onboarding ends up being unique, and builds a form or workflow that standardizes it.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;These people often work in isolation because organizations don’t recognize what they’re doing as engineering. But it &lt;em&gt;is&lt;/em&gt; engineering - just applied to people, processes, and information ins tead of servers and code.&lt;/p&gt;
&lt;h2 id=&quot;start-small%2C-then-scale&quot; tabindex=&quot;-1&quot;&gt;Start Small, Then Scale&lt;/h2&gt;
&lt;p&gt;There’s a myth that internal tools need to be fully featured products. That mindset kills most automation before it starts. A wiki page of useful commands is a great first tool. A small script that one team uses can later become an API or a workflow in Slack.&lt;/p&gt;
&lt;p&gt;The question isn’t “Can we build this perfectly?” It’s “Is this pain common enough to solve once and share?”&lt;/p&gt;
&lt;p&gt;Too many companies overengineer the idea of tooling. They spin up projects, assign teams, and stall under the weight of process. But the best tools start informally. They’re acts of curiosity, not mandates. And once proven useful, they can be hardened, shared, and maintained.&lt;/p&gt;
&lt;h2 id=&quot;build-without-overbuilding&quot; tabindex=&quot;-1&quot;&gt;Build Without Overbuilding&lt;/h2&gt;
&lt;p&gt;Code is a liability, and not every solution needs it. Some of the best internal tools aren’t codebases at all. They’re Zapier automations, Airtable forms, or Slack workflows. Platforms like Retool and Node-RED exist precisely to help non-developers build lightweight, domain-specific tools.&lt;/p&gt;
&lt;p&gt;But even there, restraint matters. Internal tools don’t need to impress anyone; they need to save time. David Tuite calls this out in his essay on “&lt;a href=&quot;https://www.davidtuite.com/hidden-const-mediocre-internal-tools/&quot;&gt;the hidden cost of mediocre internal tools&lt;/a&gt;”: if a tool is 80% right and saves hours a week, that’s success. Perfection is the enemy of progress.&lt;/p&gt;
&lt;h2 id=&quot;the-cultural-blind-spot&quot; tabindex=&quot;-1&quot;&gt;The Cultural Blind Spot&lt;/h2&gt;
&lt;p&gt;Here’s the uncomfortable part: most companies don’t reward toolsmiths. They celebrate heroics instead. Everyone hears about the engineer who pulls an all-nighter, the support rep who clears a backlog manually. But &lt;a href=&quot;https://sre.google/resources/practices-and-processes/no-heroes/&quot;&gt;we don’t need any more superheroes&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;A toolsmith’s work is quieter. It’s the absence of pain, not the spectacle of solving it. But that quiet efficiency compounds. Each script, dashboard, and workflow removes another point of friction - another snowflake. Over time, it transforms the company’s metabolism.&lt;/p&gt;
&lt;p&gt;The irony is that the companies best at building products for others are often the worst at building tools for themselves.&lt;/p&gt;
&lt;h2 id=&quot;melting-snowflakes-at-scale&quot; tabindex=&quot;-1&quot;&gt;Melting Snowflakes at Scale&lt;/h2&gt;
&lt;p&gt;Empowering toolsmiths doesn’t mean spinning up a new “internal tools” department. It means creating permission structures that let anyone automate what hurts. It means treating those efforts as strategic, not peripheral. Give them time to do the work, and access to the systems they need.&lt;/p&gt;
&lt;p&gt;Imagine if every engineer, analyst, and operations specialist had an hour a week to improve their own workflow. Imagine if they had access to shared infrastructure. A data warehouse, a Retool instance, a place to share scripts safely. The compound effect would dwarf most process initiatives.&lt;/p&gt;
&lt;p&gt;That’s how you grow fast without breaking things: you melt snowflakes before they become avalanches.&lt;/p&gt;
&lt;h2 id=&quot;build-systems%2C-not-empires&quot; tabindex=&quot;-1&quot;&gt;Build Systems, not Empires&lt;/h2&gt;
&lt;p&gt;Organizations love to talk about scale, but scale doesn’t come from adding headcount. It comes from eliminating friction. Toolsmiths are the people who make that possible.&lt;/p&gt;
&lt;p&gt;If you want to grow, don’t just hire more hands. Empower the ones you have to build better tools. Give them permission to tinker. Recognise their work.&lt;/p&gt;
&lt;p&gt;Because every snowflake you melt makes your company a little stronger.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Parse Codex `jsonl` with `jq`</title>
    <link href="https://michaelheap.com/extract-codex-conversation/"/>
    <updated>2025-12-12T16:27:46Z</updated>
    <id>https://michaelheap.com/extract-codex-conversation/</id>
    <content type="html">&lt;p&gt;I recently &lt;a href=&quot;https://michaelheap.com/gh-saved-issues/&quot;&gt;built a GitHub extension&lt;/a&gt; using ChatGPT Codex, and I wanted to share the prompts that I gave to Codex to build the tool.&lt;/p&gt;
&lt;p&gt;I thought about copy/pasting it out of the VSCode UI, but figured that the data must be available somewhere. It turns out that Codex stores sessions as &lt;code&gt;.jsonl&lt;/code&gt; files in &lt;code&gt;.codex/sessions&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Looking through the session files, there&#39;s a ton of data in there around what the LLM does, but I was only interested in messages that I sent. Fortunately each user message has &lt;code&gt;type: user_message&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Here&#39;s a one liner that uses &lt;code&gt;jq&lt;/code&gt; to output all of the user messages for a given session:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;cat .codex/sessions/2025/12/04/rollout-2025-12-04T22-06-28-019aeb67-0620-71c1-8cbb-756bc8845c6e.jsonl &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  jq -r &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;. |&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;  select(.payload.type == &quot;user_message&quot;) |&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;  .payload.message |&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;  split(&quot;&#92;n## My request for Codex:&#92;n&quot;)[1] + &quot;&#92;n&#92;n--- NEW COMMAND ---&#92;n&#92;n&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
</content>
  </entry>
  
  <entry>
    <title>Building `gh-saved-issues` using ChatGPT Codex</title>
    <link href="https://michaelheap.com/gh-saved-issues/"/>
    <updated>2025-12-12T07:59:44Z</updated>
    <id>https://michaelheap.com/gh-saved-issues/</id>
    <content type="html">&lt;p&gt;I spend a &lt;em&gt;lot&lt;/em&gt; of time on the &lt;code&gt;/issues&lt;/code&gt; page on GitHub. Working across multiple repos in multiple orgs, it can be difficult to keep up to date on what&#39;s happening. &lt;code&gt;/issues&lt;/code&gt; allows me to see everything on a single page.&lt;/p&gt;
&lt;p&gt;The &lt;code&gt;/issues&lt;/code&gt; page allows you to create saved searches and view them when needed. Here are a couple of examples that I use every day:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #616E88&quot;&gt;# My PRs that are awaiting review&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;is:pr author:@me state:open org:Kong -draft:true&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #616E88&quot;&gt;# Issues open on my personal projects (excluding dependency updates + my blog)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;state:open archived:false sort:updated-desc user:mheap -author:app/dependabot -repo:mheap/michaelheap.com is:issue&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;I also started out with a &amp;quot;all PRs awaiting review from me filter&amp;quot;:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #616E88&quot;&gt;# Awaiting review from me within the Kong org&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;is:pr state:open org:Kong review-requested:@me&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;However, I found that I wasn&#39;t looking at it as there were regularly too many items to review in a single session. So instead, I started segmenting my reviews by context:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #616E88&quot;&gt;# All Terraform PRs&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;is:pr state:open -author:app/renovate &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;repo:Kong/terraform-provider-konnect OR repo:Kong/terraform-provider-konnect-beta OR repo:Kong/terraform-provider-kong-gateway&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;This worked much better, but then I realised that I&#39;d need to keep 90% of the search consistent, but change the repos being shown for various different contexts.&lt;/p&gt;
&lt;p&gt;So I did what anyone would - I started reverse engineering the GraphQL queries needed to configure saved searches and building a configuration file with template support.&lt;/p&gt;
&lt;p&gt;If you&#39;re just looking for the tool, you can find it at &lt;a href=&quot;https://github.com/mheap/gh-saved-issues&quot;&gt;mheap/gh-saved-issues&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;This tool is my first attempt at building something with an agent. Keep reading to see my experience.&lt;/p&gt;
&lt;h3 id=&quot;building-with-codex&quot; tabindex=&quot;-1&quot;&gt;Building with Codex&lt;/h3&gt;
&lt;p&gt;I did some research before prompting Codex, including extracting &lt;code&gt;curl&lt;/code&gt; commands from developer tools. I pasted these commands into my initial prompt&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;You are an expert Go developer. You have been tasked to build a GitHub CLI extension to configure saved searches on GitHub. The CLI layer should be very thin, and all of the logic for working with the API must be included in library files.&lt;/p&gt;
&lt;p&gt;The tool should accept a configuration file (located at $XDG_CONFIG_HOME/.github-searches.yaml) in the following format:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;yaml&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;searches&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Assigned to me (Kong)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;state:open archived:false assignee:@me sort:updated-desc org:Kong&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Assigned to Steve (All Orgs)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;state:open archived:false assignee:steve.doe sort:updated-desc&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Work from Alice&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;template&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;recent-work&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;vars&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;alice.jones&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;7d&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Work from Bob&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;template&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;recent-work&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;vars&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;bob.smith&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;templates&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;	&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;recent-work&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;	  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;org:Kong ((assignee:{{ user }} AND is:issue) OR (is:pr AND author:{{ user }})) (is:open OR updated:&amp;gt;@today-{{ default(time, &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;30d&quot;) }}) sort:updated-desc&quot;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;If the search has an &lt;code&gt;id&lt;/code&gt; associated with it, update the existing rule. Otherwise create a new one then update the configuration file to set the &lt;code&gt;id&lt;/code&gt; value.&lt;/p&gt;
&lt;p&gt;To create a new saved issue search, make the following request (but use Go, don&#39;t shell out to curl):&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;curl &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;https://github.com/_graphql&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  --data-raw &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;{&quot;query&quot;:&quot;c06c5627e09922bd28c6d34ff91d0530&quot;,&quot;variables&quot;:{&quot;input&quot;:{&quot;color&quot;:&quot;GRAY&quot;,&quot;icon&quot;:&quot;BOOKMARK&quot;,&quot;name&quot;:&quot;Untitled view&quot;,&quot;query&quot;:&quot;&quot;,&quot;searchType&quot;:&quot;ISSUES&quot;}}}&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;To update a search, use this request (shortcutId is the &lt;code&gt;id&lt;/code&gt; from the config):&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;curl &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;https://github.com/_graphql&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  --data-raw &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;{&quot;query&quot;:&quot;379dbe4cf68c3485e48df2f699f5ae75&quot;,&quot;variables&quot;:{&quot;input&quot;:{&quot;color&quot;:&quot;GRAY&quot;,&quot;description&quot;:&quot;Test&quot;,&quot;icon&quot;:&quot;BOOKMARK&quot;,&quot;name&quot;:&quot;Demo123&quot;,&quot;query&quot;:&quot;user:mheap&quot;,&quot;scopingRepository&quot;:null,&quot;shortcutId&quot;:&quot;SSC_kgDOAB3rrw&quot;}}}&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;If a user sets &lt;code&gt;remove: true&lt;/code&gt; on a query, you can delete the search using the following request:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;curl &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;https://github.com/_graphql&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &#92;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  --data-raw &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;{&quot;query&quot;:&quot;2939ea7192de2c6284da481de6737322&quot;,&quot;variables&quot;:{&quot;input&quot;:{&quot;shortcutId&quot;:&quot;SSC_kgDOAB3rsg&quot;}}}&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;Build the CLI, and also bootstrap test cases for all library code.&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;At this point most of the work was done, except it didn&#39;t work. This graphql endpoint is not accessible using a GitHub token, it needs a cookie session to be specified&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;In addition to &lt;code&gt;req.Header.Set(&amp;quot;Authorization&amp;quot;, &amp;quot;Bearer &amp;quot;+c.token)&lt;/code&gt;, allow me to specify a cookie like:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;bash&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  -b &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;_device_id=ID_HERE; user_session=SESSION_HERE&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&#39;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &#92;&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;This made the API requests work, but I realised that updating an existing config wasn&#39;t working due to a bug in findShortcutId.&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Fix findShortcutId&lt;/p&gt;
&lt;p&gt;The response looks like the following:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;json&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;data&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;createDashboardSearchShortcut&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;dashboard&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;shortcuts&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;totalCount&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #B48EAD&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;nodes&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:[{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOAA2otQ&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;mheap: Open Issues&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;state:open archived:false sort:updated-desc user:mheap -author:app/dependabot -repo:mheap/michaelheap.com is:issue &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;icon&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;BOOKMARK&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;color&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;GRAY&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;scopingRepository&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;},{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOABdOWA&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Kong: My Open PRs&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;is:pr author:@me state:open org:Kong -draft:true&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;icon&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;BOOKMARK&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;color&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;GRAY&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;scopingRepository&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;},{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOABdOZw&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Kong: Awaiting Review from Me&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;is:pr state:open org:Kong review-requested:@me -repo:Kong/platform-api &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;icon&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;BOOKMARK&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;color&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;GRAY&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;scopingRepository&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;},{&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOABdOaA&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;mheap: Awaiting Review from Me&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;state:open archived:false sort:updated-desc user:mheap -author:app/dependabot -repo:mheap/michaelheap.com is:pr &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;icon&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;BOOKMARK&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;color&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;GRAY&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;description&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;scopingRepository&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;null&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;}&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;Search for &amp;quot;name: Kong: My Open PRs&amp;quot; and extact the &lt;code&gt;id&lt;/code&gt; field from that value&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;This worked, but was inefficient. Codex walked every node in the tree looking for IDs.&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;You don&#39;t have to walk the tree. The data is always in data.createDashboardSearchShortcut.dashboard.shortcuts.nodes&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Success! Now let&#39;s add some new capabilities&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Now group the searches by &lt;code&gt;section&lt;/code&gt;. For each section, create an empty query with the title &amp;quot;== $SECTION ==&amp;quot; above the list of items&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;This worked, but didn&#39;t feel right to me.&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Actually, I changed my mind. Don&#39;t use &lt;code&gt;section&lt;/code&gt; in a config. Instead, sections will be defined explicitly e.g.&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;yaml&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;searches&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;section&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Demo&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOAB5MiA&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Test 1&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;state:open archived:false assignee:@me sort:updated-desc org:Kong&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;template&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;vars&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;{}&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;remove&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;false&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOAB5MiQ&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Work from Alice&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;template&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;recent-work&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;vars&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;30d&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;alice.jones&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;remove&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;false&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;templates&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;recent-work&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;org:Kong ((assignee:{{ user }} AND is:issue) OR (is:pr AND author:{{ user }})) (is:open OR updated:&amp;gt;@today-{{ default(time, &quot;30d&quot;) }}) sort:updated-desc&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Much better! But my section configs were being given a &lt;code&gt;query&lt;/code&gt; entry unexpectedly in the updated config like this:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;yaml&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOAB5MiA&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;section&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Demo&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;template&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;vars&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;{}&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;remove&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;false&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;p&gt;I wanted it to look like this:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;yaml&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;SSC_kgDOAB5MiA&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;section&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Demo&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Do not replace section configs with a full query object. It should contain only &lt;code&gt;id&lt;/code&gt; and &lt;code&gt;section&lt;/code&gt;&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Everything looked good at this point. I wanted to try recreating everything so that the order in my config file is respected (right now, the section is the last item as it&#39;s the most recently created)&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Add a --force flag to the CLI that deletes all existing configs and recreates them, even if an ID is set&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;It worked, but I realised that the flag name should really be &lt;code&gt;--recreate&lt;/code&gt;.&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Rename the force flag to --recreate&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;How about use cases where I want to remove all saved searches without recreating them?&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Also add a --reset flag that removes all entries without creating anything&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;At this point, the CLI was finished. It can create saved searches, with section markers and recreate all saved searches to enforce ordering.&lt;/p&gt;
&lt;p&gt;But I wasn&#39;t done. I had an idea for another template, but needed a way to provide multiple repos as a list:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Add support for the join function in templates. Example usage:&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;yaml&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;Terraform PRs&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;template&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;repo-prs&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;vars&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;repos&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;repo:Kong/terraform-provider-konnect&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;repo:Kong/terraform-provider-konnect-beta&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;repo:Kong/terraform-provider-kong-gateway&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;yaml&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;repo-prs&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;is:pr state:open ({{ join(repos, &quot;OR&quot;) }}) -author:app/renovate draft:false {{ additional }}&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;Uh oh! There&#39;s a bug. I used &lt;code&gt;{{ additional }}&lt;/code&gt; in the template to add additional filters using a free-form string. If there are no additional parameters, I expected it to resolve to an empty string (meaning &amp;quot;no additional filters&amp;quot;).&lt;/p&gt;
&lt;p&gt;However, if a config didn&#39;t specify an empty string we got an error. I pasted the error message into Codex to try and fix it:&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;template: query:1: function &amp;quot;additional&amp;quot; not defined - can the template code treat missing values as null?&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;All working as expected, but how do people know how to use it?&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Produce a &lt;a href=&quot;http://readme.md/&quot;&gt;README.md&lt;/a&gt; teaching people how to use this tool&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;The README mentions a &lt;code&gt;--config&lt;/code&gt; flag, but it doesn&#39;t exist. Sounds like a good idea to me&lt;/p&gt;
&lt;div class=&quot;ai-input&quot;&gt;
&lt;div class=&quot;ai-header&quot;&gt;
📝 Prompt
&lt;/div&gt;
&lt;div class=&quot;ai-body&quot;&gt;
&lt;p&gt;Implement the --config flag like the README indicates&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;At this point, I had something I wanted to ship 🎉&lt;/p&gt;
&lt;h3 id=&quot;reflection&quot; tabindex=&quot;-1&quot;&gt;Reflection&lt;/h3&gt;
&lt;p&gt;Honestly, I had a great time building this tool. I&#39;m not sure it was faster than writing it by hand, but I did it in the background while doing something else and it ended up saving me a ton of time. If I had to write it by hand, I probably wouldn&#39;t have finished this project.&lt;/p&gt;
&lt;p&gt;I &lt;em&gt;did&lt;/em&gt; do a little bit extra by hand after the session above. I added a GitHub Action to build and release the extension, which means you can run it with &lt;code&gt;gh extension install https://github.com/mheap/gh-saved-issues&lt;/code&gt;.&lt;/p&gt;
</content>
  </entry>
  
  <entry>
    <title>Display mirroring with Hammerspoon</title>
    <link href="https://michaelheap.com/toggle-mirroring-hammerspoon/"/>
    <updated>2025-12-08T13:59:48Z</updated>
    <id>https://michaelheap.com/toggle-mirroring-hammerspoon/</id>
    <content type="html">&lt;p&gt;I need to mirror my screens periodically - enough that it&#39;s painful to go in to system settings each time and configure mirroring.&lt;/p&gt;
&lt;p&gt;Here&#39;s a Hammerspoon snippet that will toggle mirroring. It works because &lt;code&gt;allScreens&lt;/code&gt; returns a single value if your second screen is mirroring the first.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;C34H89x&lt;/code&gt; and &lt;code&gt;LC49G95T&lt;/code&gt; are my screen names, which I looked up in system settings.&lt;/p&gt;
&lt;pre class=&quot;shiki nord&quot; style=&quot;background-color: #2e3440ff; color: #d8dee9ff&quot;&gt;&lt;div class=&quot;language-id&quot;&gt;lua&lt;/div&gt;&lt;div class=&quot;code-container&quot;&gt;&lt;code&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;hs&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;hotkey&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;bind&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;({ &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;cmd&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;alt&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;ctrl&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;shift&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;}, &lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;M&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;function&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;	&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;local&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screens&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;hs&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screen&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;allScreens&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;	&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screens&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #B48EAD&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;then&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;		&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screens&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color: #B48EAD&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;]:&lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;mirrorStop&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;()&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;	&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;else&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;		&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;local&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screenToMirror&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;hs&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screen&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;find&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;C34H89x&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;		&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;local&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screenToHide&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt; &lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;hs&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screen&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;find&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #A3BE8C&quot;&gt;LC49G95T&lt;/span&gt;&lt;span style=&quot;color: #ECEFF4&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;		&lt;/span&gt;&lt;span style=&quot;color: #8FBCBB&quot;&gt;screenToHide&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color: #88C0D0&quot;&gt;mirrorOf&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9&quot;&gt;screenToMirror&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;	&lt;/span&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;end&lt;/span&gt;&lt;/div&gt;&lt;div class=&quot;line&quot;&gt;&lt;span style=&quot;color: #81A1C1&quot;&gt;end&lt;/span&gt;&lt;span style=&quot;color: #D8DEE9FF&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;/code&gt;&lt;/div&gt;&lt;/pre&gt;
</content>
  </entry>
</feed>