hyperdecks

Friendly npm package name for the Hypersocial Decks CLI.

pnpm dlx hyperdecks whoami
pnpm dlx hyperdecks deck list
pnpm dlx hyperdecks activity --limit 20
pnpm dlx hyperdecks import ./claude-design-export.zip --slug acme-pitch
pnpm dlx hyperdecks skills install

Global install:

pnpm add -g hyperdecks
hyperdecks whoami
decks whoami

hyperdecks wraps @hypersocial/decks-cli, so both package names use the same implementation and credential store:

~/.config/hypersocial-decks/credentials.json

Production is the default target. Use --dev only for local implementation testing with an explicit Convex URL.

Claude Design Imports

Export a Claude Design deck as standalone HTML or ZIP, then import it from a local file or a downloadable export URL:

hyperdecks import ./claude-design-export.zip --slug acme-pitch --title "Acme Pitch"
hyperdecks import https://example.com/claude-design-export.zip --slug acme-pitch
hyperdecks share new acme-pitch "Jane at Acme"

hyperdecks and decks are the same CLI (this package exposes both bins).

Hyperdecks uploads the export, rewrites local assets, and serves it through recipient links with live engagement analytics. The URL form must resolve to the downloadable export bytes (ZIP/HTML) — a claude.ai/design/p/... page is not importable on its own; http(s) only, loopback/private hosts refused.

Agents can run the same import through the hypersocial-decks MCP server's import_deck_from_url tool (input { url, slug?, title?, status? }), which uses the stored CLI credential — run hyperdecks login --prod first.

Agent Skill

Install the bundled Codex skill:

hyperdecks skills install

This delegates to npx skills add, installing the bundled skill for Codex and Claude Code by default. Use --agent <ids> for specific agents or --all-agents for every supported agent.