Command-line tool for working with Shuffle Editor projects, design sessions, and redesign sessions from your terminal.
Use it to sign in to Shuffle, list and download projects, sync project files, generate new designs, redesign existing pages, and save generated projects for later use.
examples/design-slack-bot contains a Slack bot that uses this CLI to create designs from Slack mentions or direct messages. See the example README for Slack app setup instructions.
examples/redesign-offer-automation includes an automation that redesigns prospects’ websites and sends the saved redesign as an offer using Resend.
Run the CLI with npx:
npx @shuffle-dev/cli --helpOr install it globally:
npm install -g @shuffle-dev/cli
shuffle --helpAll examples below use npx @shuffle-dev/cli. If you installed the CLI globally, replace it with shuffle.
Sign in to your Shuffle account:
npx @shuffle-dev/cli authYour browser opens automatically so you can complete sign-in.
When running the CLI on a remote server, bind the callback on the server and open the printed URL from your desktop browser:
npx @shuffle-dev/cli auth --no-opennpx @shuffle-dev/cli auth --host SERVER_IP --no-openBy default, the CLI listens on 0.0.0.0 and uses the first non-local IPv4
address it can find for the callback URL. Use --host when the server has a
public IP or DNS name that differs from its network interface address.
Sign out:
npx @shuffle-dev/cli logoutList your Shuffle projects:
npx @shuffle-dev/cli projectsList projects already downloaded with the CLI:
npx @shuffle-dev/cli listDownload a project:
npx @shuffle-dev/cli get PROJECT_IDDownload a project to a specific folder:
npx @shuffle-dev/cli get PROJECT_ID ./my-projectSync the latest Shuffle project files to your downloaded copy:
npx @shuffle-dev/cli sync PROJECT_IDChoose a project interactively and sync it:
npx @shuffle-dev/cli syncCheck project status from a downloaded project folder:
npx @shuffle-dev/cli statusClean up saved references to folders that no longer exist:
npx @shuffle-dev/cli cleanupThis command creates new projects based on a text description using top generative AI models. You can choose from available models, generate screenshots, and download generated files. The online version of this feature is available at AI Design Arena.
List available Design models:
npx @shuffle-dev/cli design modelsCreate a Design session:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform"Create a Design session and run every active model without opening the model picker:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform" --allCreate a Design session with a specific model:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform" --model claude-opus-4-6Generate screenshots for created projects:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform" --screenshotSave the generated edit, preview, and screenshot URLs to a file for later use with AI agents or manual review:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform" --screenshot --save-output ./shuffle-output.txtDownload generated project files after each successful run:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform" --download ./generatedDownload only source files:
npx @shuffle-dev/cli design create "Landing page for a B2B support automation platform" --download ./generated --source-onlyList and inspect Design and Redesign sessions:
npx @shuffle-dev/cli design sessions
npx @shuffle-dev/cli design show SESSION_HASHGenerate or refresh a screenshot for a generated project:
npx @shuffle-dev/cli design screenshot PROJECT_SESSION_IDThis command redesigns an existing web page based on a text description using top generative AI models. You can choose from available models, generate screenshots of new projects, and download generated files. The online version of this feature is available at AI Website Redesign.
Create a Redesign session from an existing URL:
npx @shuffle-dev/cli redesign create https://example.com "Keep the content, make it modern"Run every active Redesign-capable model:
npx @shuffle-dev/cli redesign create https://example.com "Keep the content, make it modern" --allCreate a Redesign session with screenshots and saved output:
npx @shuffle-dev/cli redesign create https://example.com "Keep the content, make it modern" --screenshot --save-output ./redesign-output.txtThe design create and redesign create commands support these options:
--model <id>: Run one model. You can repeat the option or pass comma-separated model IDs.--all: Run all active models without opening the model picker.--download [directory]: Download generated project files after each successful run.--source-only: When used with--download, download only source files.--screenshot: Generate a screenshot for each project after it is created.--save-output <file>: Save generated project URLs to a file. When used with--screenshot, screenshot URLs are included too.
- Sign in:
npx @shuffle-dev/cli auth - List projects:
npx @shuffle-dev/cli projects - Download a project:
npx @shuffle-dev/cli get PROJECT_ID - Edit the project in Shuffle
- Sync the latest files:
npx @shuffle-dev/cli sync PROJECT_ID
Use the full npx command:
npx @shuffle-dev/cli COMMANDOr install the CLI globally:
npm install -g @shuffle-dev/cli
shuffle COMMAND- Make sure your browser allows the sign-in page to open.
- Make sure ports 8080-8085 are available for the sign-in callback.
- On a remote server, make sure the callback port is reachable from your desktop or pass
--port PORTfor an allowed port.
- Check your internet connection.
- Check firewall or proxy settings if your network blocks outbound requests.
- Make sure you have write permissions in the target folder.
- Check that the target disk has enough free space.
Need help? Contact the Shuffle team at support@shuffle.dev or report an issue in the project repository.