Vifu CLI

The Vifu CLI is the developer tool for local game projects.

Use it to set up projects, build static web output, deploy playable cloud games, publish, and understand deploy errors.

Install

curl -fsSL https://vifu.dev/cli | bash
vifu --help

npm remains available when the native installer is not available:

npm install -g @vifu/cli@alpha
vifu --help

Project-local:

npm install --save-dev @vifu/cli@alpha
npx vifu --help

Create projects with the npm initializer:

npm create @vifu/vifu my-game -- --template vanilla --no-interactive

Create an account at vifu.ai, then log in:

vifu login

Common Commands

Command	Purpose
vifu login	Sign in for deploy and publish workflows.
vifu logout	Sign out for the current API environment.
vifu logout --all	Clear all cached Vifu credentials.
vifu setup	Detect and configure the current game project.
vifu build	Build the project from the current directory.
vifu build ./game	Build another project directory.
vifu run	Serve or run a local game project.
vifu test	Run supported local game test workflows.
vifu deploy	Build, validate, upload, and create a playable cloud URL.
vifu publish	Lower-level publish command for prepared builds and marketplace flows.

Deploy

vifu deploy

What happens:

1. Run project setup when it is missing and the project can be detected.
2. Validate the project setup.
3. Build the project unless --no-build is passed.
4. Check the built game files.
5. Upload only if validation passes and the artifact changed.
6. Share a playable URL unless --no-share is passed.

Useful flags:

vifu deploy --dry-run
vifu deploy --yes
vifu deploy --no-setup
vifu deploy --no-build
vifu deploy --no-share
vifu deploy --name my-stable-game-name

Manage Games

vifu games list
vifu games share <game-id>
vifu games submit <game-id>
vifu games delete <game-id>

Management commands use the same Vifu Cloud account as deploy.

Optional Diagnostics

vifu manifest check
vifu manifest explain

You usually do not need these before vifu deploy; deploy checks the manifest for you. Use them only when you want a quick local diagnosis or CI check without building or uploading.

Existing Projects

To adapt an existing browser game:

1. Run vifu setup.
2. Confirm the HTML entry, build command, and build output.
3. Build to static browser files.
4. Replace direct AI/backend calls with the Vifu SDK.
5. Run vifu deploy.

Read Deploy Policy before adapting games that import JavaScript from a CDN or call external AI APIs.

For coding-agent workflows, install the separate Vifu Agent Skill.