martinrue/hypeplan

Hypeplan is a small command line tool that takes a plain, markdown based project plan and turns it into an over the top ASCII keynote presentation, complete with a synthesized voice reading it out loud in your terminal. Instead of just reading a wall of text describing a plan, you get something closer to a stage performance, with the plan's content dramatically narrated segment by segment. To use it, you pipe a markdown plan into the tool, either from a file or the clipboard. The tool checks that what it receives looks like an actual plan, by looking for a heading, bullet points or numbered lists, and planning related words like summary, implementation, scope, rollout, or test plan. It then generates a presentation script and turns that script into spoken audio using OpenAI's models, playing it back through your system's audio player while showing an ASCII animation in the terminal. You can customize the experience with command line flags: choosing between a few built in voices, picking a different presentation style, swapping the underlying script or text to speech models, adjusting playback speed, or forcing it to skip cached results and regenerate everything from scratch. While playing, you can move forward or backward through segments with the arrow keys, or quit at any time. Running it requires the Bun JavaScript runtime, an OpenAI API key since the script and audio generation both call OpenAI's models, and an audio player already installed on your machine, such as afplay on macOS or ffplay on other systems. Generated scripts and audio are cached locally so repeat runs of the same plan do not need to regenerate everything. This is a playful, joke leaning side project rather than a serious productivity tool, best suited to developers who want a fun way to present their own plans to themselves or a small audience. No license is stated in the README.