POSH TUI

POSH TUI: may and april update

31 May 2026

You’re receiving this email because you bought a Posh TUI license or subscribed. This is a project progress update.

This is a two-month update. I forgot to hit ‘send’ for a previous month’s update.

NB! Important note: Remove all previous data with posh clear.

The entire codebase, all rendering gems (yard-markdown, rdoc-markdown), and even some dependencies have been improved. Many issues were discovered through mutation testing.

Why did I do that?

I will have to rebuild a big part of docsets if bugs in yard-markdown and rdoc-markdown surface. And this is not a fast process; it takes at least a couple of days to rebuild the entire library.

100% mutant testing coverage is a high enough bar that helps me sleep better at night. Posh TUI went all in on mutant testing (and fuzz testing in some places).

According to Google research papers, such testing strategies could prevent 3 out of 4 issues in production.

We’re now storing documentation for ~2600 gems, 2 GB of CDN space. Most of these are top-downloaded gems from RubyGems, but we also add more gems based on requests from the Posh TUI client.

Major changes for Posh TUI itself:

  • New documentation type: ‘guides’
  • In-document search
  • Improved docsets downloader (error handling, parallelization, etc.)
  • many small tweaks and fixes

Next month I will be dedicating even more of my own time towards this project. So I need your feedback more than ever. Please run brew update; brew upgrad test Posh TUI and your project and send me your feedback. I will have plenty of time to address it.

My personal plan is to keep adding more documentation and working on better search.

Thank you for the support.

Development updates