Adapt, deploy, and observe your projects on Velobase Cloud.
npm install -g @velobaseai/cloud-cli# Sign in to Velobase Cloud
velobase-cloud login
# Connect your GitHub account
velobase-cloud github connect
# Initialize your project
cd your-project
velobase-cloud init
# Generate AI adaptation context
velobase-cloud adapt
# Check deployment readiness
velobase-cloud doctor
# Push to deploy
git push origin main| Command | Description |
|---|---|
login |
Sign in via browser (Device Auth Flow) |
logout |
Clear local credentials |
whoami |
Show current user |
github connect |
Connect your GitHub account |
github status |
Show GitHub connection status |
init |
Initialize project for Cloud deployment |
adapt |
Generate AI adaptation context (.velobase/) |
doctor |
Check deployment readiness (7 checks) |
status |
Show project and runtime status |
deploy trigger |
Trigger deployment via GitHub Actions |
deploy runs |
List recent workflow runs |
deploy rollback <id> |
Rollback to a previous deployment |
logs pods |
List running pods |
logs pod <name> |
Show pod logs |
logs deploy [id] |
Show deployment logs |
env list |
List environment variables |
env set <key> <value> |
Set an environment variable |
env delete <key> |
Delete an environment variable |
config set <key> <value> |
Set CLI configuration |
config show |
Show current configuration |
-
velobase-cloud initscans your project, detects the tech stack (Velobase Harness or generic), creates a Cloud project with all infrastructure (PostgreSQL, Redis, K8s, domain), writes the GitHub Actions deploy workflow, and configures secrets. -
velobase-cloud adaptgenerates.velobase/ai-prompt.mdwith deployment constraints and adaptation instructions. Feed this to your IDE AI to make your project Cloud-ready. -
velobase-cloud doctorruns 7 local checks: Dockerfile, port 3000, /healthz, DB migration, workflow, secrets, env validation. -
After
git push, GitHub Actions builds the Docker image, pushes to ACR, and triggers deployment via the Velobase Deploy API.
CLI config is stored in ~/.velobase-cloud/:
credentials.json— CLI access tokenconfig.json— API base URL and other settings
Project config is stored in .velobase/:
config.json— Project binding (project ID, subdomain)ai-prompt.md— AI adaptation instructions
MIT