VifuHub CLI

The VifuHub CLI is the developer tool for local interactive experience and game projects. It connects a project to VifuHub managed publishing and playtesting.

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

Install

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

Project-local:

npm install --save-dev @vifu/vf
npx vf --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:

vf login

Common Commands

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

Deploy

vf 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:

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

Manage Games

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

Management commands use the same VifuHub account as deploy.

Optional Diagnostics

vf manifest check
vf manifest explain

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

Bring A Browser Game To VifuHub

To bring an existing browser game to VifuHub:

1. Run vf setup.
2. Confirm the HTML entry, build command, and build output.
3. Build to static browser files.
4. Use VifuHub for the host capabilities your game needs.
5. Run vf deploy.

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

For coding-agent workflows, install the separate VifuHub CLI Skill.