Hypeplan: Turn plans into terminal keynote speeches

afisxisto1 pts0 comments

GitHub - martinrue/hypeplan: Turn your boring plans into ASCII keynote speeches · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

martinrue

hypeplan

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>1 Commit<br>1 Commit

src

src

test

test

.gitignore

.gitignore

LICENSE

LICENSE

README.md

README.md

bun.lock

bun.lock

hypeplan.png

hypeplan.png

package.json

package.json

tsconfig.json

tsconfig.json

View all files

Repository files navigation

Hypeplan

Listen up bozo, you got two options:

1: Keep reading your shitty text-based plans.

2: Have your plan delivered to you as an ASCII keynote speech in your terminal.

If you really think there's a choice here, you're ngmi.

What the...?

Hypeplan takes a normal markdown-based plan and hypes it.

Suddenly the plan has its own stage, a keynote speaker, an audience and becomes infinitely more convincing.

I still don't...

Jesus, just look...

... or watch

But why

Because normal projects already exist.

I asked "what if?" exactly once.

There was a lack of adult supervision.

And it's now way too late for that question buddy.

I'm down, what do I need?

Bun

An OpenAI API key

An audio player:<br>afplay on macOS, or ffplay elsewhere

Install

.env<br>cat plan.md | ./hypeplan">git clone git@github.com:martinrue/hypeplan.git<br>cd hypeplan<br>bun install<br>bun dist<br>echo "OPENAI_API_KEY=your-openai-api-key" > .env<br>cat plan.md | ./hypeplan

Arguments

Hypeplan supports these flags:

--voice<br>Use a specific TTS voice. Supported built-in defaults are coral, marin, and cedar.

--style<br>Choose the presentation style prompt. The default is product-keynote.

--script-model<br>Override the model used to generate the presentation script.<br>Default: gpt-5.4-mini

--tts-model<br>Override the model used to generate speech audio.<br>Default: gpt-4o-mini-tts

--tts-speed<br>Set speech speed to any positive number.<br>Default: 1

--no-cache<br>Regenerate the script and audio instead of using cached assets.

Runtime controls

Right Arrow<br>Skip to the next segment of the keynote

Left Arrow<br>Go back to the previous segment

Esc, Ctrl-C, q<br>Quit

The plan

Hypeplan expects a markdown-based plan to be piped in on stdin or to be present on the clipboard.

To check it's a valid plan, hypeplan looks for:

a heading

bullets or numbered items

plan-oriented language such as summary, implementation, scope, rollout, or test plan

Caching

Generated assets are cached under .cache/.

Use --no-cache if you want to force regeneration.

About

Turn your boring plans into ASCII keynote speeches

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

stars

Watchers

watching

Forks

forks

Report repository

Releases

No releases published

Packages

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

TypeScript<br>100.0%

You can’t perform that action at this time.

hypeplan plan keynote reload search commit

Related Articles