Skip to content

docs(readme): the demo GIF builds a CLI from Notion's own OpenAPI description - #192

Merged
leemour merged 1 commit into
mainfrom
docs/notion-gif
Nov 18, 2026
Merged

leemour merged 1 commit into
mainfrom
docs/notion-gif

Conversation

@leemour

@leemour leemour commented Nov 18, 2026

Copy link
Copy Markdown
Member

The README GIF used PokeAPI, showed 0.25.0, and spent most of its time waiting. The new one is recorded from the published 0.29.0 and shows a real service people use:

  1. npx @wirecat/cli-template new notion-cli --preset generic --sign-in token --spec-url with Notion's own OpenAPI description (the one in makenotion/notion-mcp-server, pinned to cf16e5c), and the new short summary.
  2. pnpm install && pnpm generate, the wait cut, time prints how long it took (12 s here).
  3. ls of what was written: the spec and its provenance, src/generated, the skill's API pages.
  4. api list tag:Pages and pages-markdown-list --help, which shows the Notion-Version default from the spec.

No sign-in, no call to Notion, invented owner acme. The GIF is now 1000 px wide (144 KB) so the help text is readable; the README shows it at 800.

🤖 Generated with Claude Code

…cription

The old GIF used PokeAPI, showed 0.25.0, ran the long setup in front of the viewer and waited between commands.
The new one, recorded from the published 0.29.0, shows new on Notion's description (makenotion/notion-mcp-server,
pinned), the short summary, install and generate with the wait cut and its time printed, the files it wrote,
the Pages commands and one command's help. Only invented names, no sign-in, no call to Notion.

The GIF is 1000 px wide now, so the help text stays readable; the README shows it at 800.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@leemour
leemour merged commit 05c5659 into main Nov 18, 2026
16 checks passed
@leemour
leemour deleted the docs/notion-gif branch November 18, 2026 08:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant