kokoro-slide

Turn what you want to get across into a 6-slide talk, in Markdown — with what to say in the speaker notes. Open it with Marp to see it as slides.

export ANTHROPIC_API_KEY=sk-ant-...
npx kokoro-slide "a pitch for a small bakery using local wheat, for families"   # writes kokoro-slide.md
npx kokoro-slide notes.md                                                       # writes notes.slides.md

Easiest: ask your AI to run it

No terminal skills needed. If you work with an AI coding tool (Claude Code etc.), ask it:

Run npx kokoro-slide notes.md in this folder and show me the result.

Needs your Anthropic API key on your machine (ANTHROPIC_API_KEY). Set it once in your system's environment variables, then restart your AI tool — Windows: search "environment variables" in Settings; macOS/Linux: add export ANTHROPIC_API_KEY=... to ~/.zshrc or ~/.bashrc. ★Do not paste your key into the AI chat — it stays in the conversation history.

The commands above are for running it yourself in a terminal.

• Free, no sign-up. Runs on your Anthropic API key (Claude Haiku); AI costs are billed to that key.
• One message per slide. Six slides in a fixed order: title, problem, solution, value, the point in one line, next step. Each slide carries only a few words; what to say goes in the speaker notes.
• See it as slides: open the .md in VS Code with the Marp for VS Code extension and show the preview. What to say is written in <!-- --> comments in the .md; they are not shown in the preview, and Marp turns them into speaker notes when you export.
• It does not invent quietly. If you give it nothing to say (just "hello"), you get [ ] blanks to fill in. If the AI added a date or time that was not in your text, it lists it for you to check.
• The slides follow your language. Text that contains instructions to an AI (such as a spec) is read as material, not followed.
• Your text goes straight from your machine to Anthropic — not through the Kokoro OS server — and is not stored. Up to 60,000 characters.

Options: <file or "text"> --out name.md --yes --lang ja|en

Related: decide what to build with kokoro-baton; write documents with kokoro-writer; make tables with kokoro-kami; check what you built with kokoro-aegis.

License

PolyForm Shield 1.0.0 — free to use for any purpose, including at work and commercially. You may not use it to build a product that competes with it.

日本語

伝えたいことを、6 枚のスライド（Markdown）にする道具です。 話す要点は発表者ノートに入ります。Marp で開くとスライドとして見えます。

npx kokoro-slide "地元の小麦で作るパン屋の開業プラン。家族連れに来てほしい"   # kokoro-slide.md ができる
npx kokoro-slide メモ.md                                                    # メモ.slides.md ができる

いちばん簡単な使い方：AI に頼む

ターミナルの操作が分からなくても使えます。Claude Code などの AI と一緒に作っているなら、その AI にこう頼んでください。

このフォルダで npx kokoro-slide メモ.md を実行して、できたものを見せてください。

あなたの Anthropic の API キーが、パソコンに入っている必要があります（ANTHROPIC_API_KEY）。一度だけ入れておき、AI の道具を開き直してください。Windows：設定で「環境変数」と検索 →「アカウントの環境変数を編集」で新しく足す。Mac：~/.zshrc に export ANTHROPIC_API_KEY=... を足す。★キーを AI との会話に貼らないでください（会話の記録に残ります）。

上のコマンドは、ターミナルで自分で打つ人向けです。

• 無料・登録なし。 あなたのキー（Claude Haiku）で動き、AI の費用はそのキーに付きます。
• 1 枚 1 メッセージ。 表紙・課題・解決策・提供価値・一言でいうと・次のステップの 6 枚です。スライドに載せる言葉は少なく、話すことは発表者ノートに入れます。
• スライドとして見るには： VS Code に拡張機能 Marp for VS Code を入れて .md を開き、プレビューを出してください。話す要点は .md の中の <!-- --> に書いてあります。プレビューには出ませんが、Marp で書き出すと発表者ノートになります。
• 黙って作り話をしません。 伝えたいことが書いていない（「こんにちは」だけなど）ときは、［　］ の空欄にします。あなたの文章に無い日時を AI が書き足したときは「確かめてください」と並べます。
• 入れた文章の言葉でスライドを作ります。AI への指示が書いてある文章（仕様書など）も、指示には従わず、材料として読みます。
• 文章は あなたのパソコンから直接 Anthropic に送られます（Kokoro OS のサーバーは通りません）。保存はしません。 60,000 字までです。
• PowerPoint で欲しいときは、Kokoro OS の画面の Slide で書き出せます（Plus）。この道具が出すのは中身（.md）だけです。

使ってよい範囲：PolyForm Shield 1.0.0。仕事でも商売でも自由に使えます。これと競合する製品を作るために使うことはできません。