VibeFast CLI

Official CLI for installing VibeFast features into your monorepo.

Installation

npm install -g @vibefastpro/vibefast-cli

Or use directly with npx:

npx @vibefastpro/vibefast-cli <command>

Quick Start

1. Login with your token:

vf login --token YOUR_TOKEN_HERE

2. Verify your setup:

vf doctor

3. List available features:

vf list

4. Install a feature:

vf add mini-native
vf add mini-web --target web

5. Remove a feature:

vf remove mini-native

Commands

vf login --token <TOKEN>

Authenticate with your VibeFast license token.

vf logout

Clear your stored token.

vf devices

List your active device activations.

Options:

• --deactivate <id> - Free up a device slot

vf doctor

Check your VibeFast setup and verify all requirements.

vf list

Show all available features for your license.

vf add <feature>

Install a feature into your project.

Options:

• --target <native|web> - Target platform (default: native)
• --dry-run - Preview changes without applying
• --force - Overwrite existing files

Example:

vf add charts --target native
vf add chatbot --target web --force

vf remove <feature>

Remove an installed feature.

Options:

• --target <native|web> - Target platform (default: native)
• --dry-run - Preview changes without applying

Example:

vf remove charts --target native

Requirements

• Node.js 18+
• A VibeFast monorepo with .vibefast/starter.json
• Valid VibeFast license token

Device Limits

Each license includes 2 device slots by default. A device is identified by a stable ID based on your machine's username, hostname, and OS. You can manage your devices with:

vf devices                    # List active devices
vf devices --deactivate <id>  # Free a slot

Troubleshooting

"Not a VibeFast repo"

• Make sure you're in the root of your VibeFast monorepo
• Check that .vibefast/starter.json exists

"Not logged in"

• Run vf login --token <YOUR_TOKEN>

"Device limit reached"

• Run vf devices to see active devices
• Deactivate unused devices with vf devices --deactivate <id>

"Missing navigation markers"

• Ensure your nav files have the required marker comments
• Run vf doctor to check

Environment Variables

• VIBEFAST_WORKER_URL - Override the API endpoint (default: https://api.vibefast.com)

Support

For issues or questions, contact [email protected]