threeui-cli
v0.3.1
Published
Find ThreeUI Community components by intent and copy their verified source and assets.
Maintainers
Readme
ThreeUI Community Finder and Source Installer
Find a free ThreeUI Community component from plain language, preview it, then copy its verified source and required assets into your project.
npx threeui-cli search "dark Japanese landing page"
npx threeui-cli add kage-landing-pageSearch reads the official labels, categories, tags and descriptions. Each result includes its ThreeUI preview URL, so you can inspect the live component before copying anything.

The Kage example above installs its HTML page, WebGL assets and editable React source in one command. Every file is checked against the SHA-256 digest in the official catalog before it is written.
Choose how you want ThreeUI
| What you need | Use |
| --- | --- |
| Community components as a dependency | Official @designcodeio/threeui |
| Free Community source in your project | npx threeui-cli add <component> |
| Licensed Pro source | Official @designcodeio/threeui-cli with account authentication |
This CLI handles the second path. It resolves the shared files and public assets required by full HTML components, preserves their original paths and refuses to replace existing files unless you ask it to.
Find and preview a component
npx threeui-cli list
npx threeui-cli search "particle badge"
npx threeui-cli show spark-badgeThen add the component from your project root.
npx threeui-cli add predictive-arc
npx threeui-cli add spark-badge --target ./appUse --dry-run to verify every file without writing it. Existing paths stop the install unless you explicitly pass --force.
Use it from a coding agent
Install the included skill.
npx skills add sjh9714/threeui-cliThen ask Codex or another SKILL.md compatible agent to add a ThreeUI component. The agent uses the same CLI rather than recreating the visual from a screenshot.
What gets copied
- The selected component source
- Every required shared source file
- Binary assets from the official repository
- Original relative paths expected by the component
Existing files are never replaced unless you pass --force. Source files and assets are checked against the digests in the official registry before anything is written.
Community catalog
The available source changes as ThreeUI Community changes. list, search and show read the live upstream registry and catalog, so this repository does not keep a stale component count or copied metadata index.

Credits
Components and source belong to ThreeUI Community and are MIT licensed. This repository is an independent source installer and is not affiliated with ThreeUI.
License
MIT
