vmux

sdan's avatarfrom sdan

Deploy to vmux cloud compute. Use when user says "deploy", "vmux", "run in cloud", "preview URL", or wants to run commands on remote compute.

⭐28stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026
[Cloud Infrastructure]

When & Why to Use This Skill

The vmux Claude skill enables instant deployment and management of commands and applications in a cloud compute environment. It allows users to transition local workflows to the cloud in seconds, providing persistent execution, automatic port forwarding for preview URLs, and comprehensive process monitoring directly through the AI interface.

Use Cases

  • Rapid Web Previewing: Deploy web servers (Node.js, Python, Bun) and instantly generate public 'purr.ge' preview URLs to share or test live applications.
  • Persistent Task Execution: Run long-running scripts or data processing jobs in the background using detached mode, ensuring tasks continue even after the user disconnects.
  • Remote Command Execution: Execute and manage shell commands on remote cloud instances to bypass local resource constraints or maintain a persistent uptime.
  • Environment-Specific Testing: Test applications with specific environment variables and runtimes (Python, Bun, Node) in a clean, isolated cloud environment.
  • Real-time Log Monitoring: Stream live logs from cloud-hosted processes to debug and monitor application performance without leaving the chat.
namevmux
descriptionDeploy to vmux cloud compute. Use when user says "deploy", "vmux", "run in cloud", "preview URL", or wants to run commands on remote compute.

vmux - Cloud Compute in 5 Seconds

Run any command in the cloud. Close your laptop, keep running.

Setup

vmux whoami  # Check login status
vmux login   # If needed

vmux run

vmux run [flags] <command>

Flags

Flag Short Description
--detach -d Run in background, return job ID immediately
--port <port> -p Expose port for preview URL (can use multiple times)
--preview Auto-detect port from framework and expose it
--env KEY=VAL -e Set environment variable
--runtime -r Force runtime: python, bun, or node

Flag Combinations

Flags can be combined: -dp 8000 = detached + port 8000

vmux run python script.py           # Streams logs, blocks
vmux run -d python script.py        # Detached, returns job ID
vmux run -p 8000 python server.py   # Expose port 8000, get preview URL
vmux run -dp 8000 python server.py  # Detached + port (most common for web)
vmux run -d --preview bun run dev   # Auto-detect port from framework
vmux run -p 3000 -p 8000 npm run dev  # Multiple ports
vmux run -e API_KEY=xxx python app.py # With env var
vmux run -r bun npm run dev         # Force bun runtime

After Deploy

Always give the user:

  1. The preview URL (if port exposed) - format: https://<job-id>.purr.ge
  2. The job ID
  3. How to monitor: vmux logs -f <job-id>
  4. How to stop: vmux stop <job-id>

Other Commands

vmux ps                 # List running jobs
vmux logs <job-id>      # Get logs
vmux logs -f <job-id>   # Follow logs in real-time
vmux attach <job-id>    # Interactive tmux session (Ctrl+B,D to detach)
vmux stop <job-id>      # Kill job
vmux stop -a            # Stop all running jobs
vmux debug <job-id>     # Show tmux status and processes
vmux secret set KEY     # Store secret in keychain