threewzrd

AI-powered CLI for generating Three.js projects from natural language.

Describe what you want to build and let the AI create complete, runnable Three.js scenes for you.

Installation

npm install -g threewzrd

Requires Node.js 18 or higher.

Quick Start

1. Get an API key from Anthropic Console

2. Start the wizard:

   threewzrd start

3. Enter your API key when prompted (it will be saved securely for future sessions)

4. Describe what you want to build:

   > Create a rotating cube with a gradient shader

The wizard will generate all necessary files (HTML, JavaScript, shaders) and guide you through running them.

Commands

threewzrd start [directory]

Start an interactive session in the specified directory (defaults to current directory).

threewzrd start
threewzrd start ./my-project

threewzrd config

View current configuration.

threewzrd config

threewzrd config --set

Set or update your API key.

threewzrd config --set

threewzrd config --delete

Delete your saved API key.

threewzrd config --delete

threewzrd config --path

Show the config file location.

threewzrd config --path

API Key Setup

Your API key is stored securely at ~/.threewzrd/.env with restricted permissions (owner read/write only).

You can also set it via environment variable:

export ANTHROPIC_API_KEY=sk-ant-...
threewzrd start

Or create a .env file in your project directory:

ANTHROPIC_API_KEY=sk-ant-...

Features

• Natural Language Input: Describe 3D scenes in plain English
• Complete Project Generation: Creates HTML, JavaScript, and shader files
• Interactive REPL: Iterate on your designs with follow-up requests
• File Management: Automatically organizes generated files
• Secure: API keys are masked during input and stored with restricted permissions
• Command Safety: Only whitelisted commands can be executed

Examples

> Create a particle system that looks like falling snow

> Make a 3D solar system with orbiting planets

> Build a terrain with procedural noise and water

> Create a first-person camera controller

Security

• API keys are stored with 0600 permissions (owner read/write only)
• Input is masked when entering API keys
• Commands are restricted to a safe whitelist (npm, npx, node, git, etc.)
• File operations are sandboxed to the working directory

License

MIT