vmux-cli 0.5.5__tar.gz → 0.6.2__tar.gz

{vmux_cli-0.5.5 → vmux_cli-0.6.2}/.gitignore

@@ -33,6 +33,7 @@ pnpm-debug.log*
 # IDE
 .idea/
 .vscode/
+.codex/
 *.swp
 *.swo
 *~
@@ -49,6 +50,7 @@ Thumbs.db
 # Cloudflare
 .wrangler/
 wrangler.toml
+worker/worker-configuration.d.ts
 
 # Build artifacts
 *.log
@@ -59,3 +61,12 @@ wrangler.toml
 
 # Docs
 VMUX.md
+
+# Local secrets — wrangler dev .vars holds API keys / OAuth secrets.
+# Never commit. Production secrets live in `wrangler secret put`.
+.dev.vars
+**/.dev.vars
+
+# Editor + tool caches
+.convx/
+.cursor/hooks/state/

{vmux_cli-0.5.5 → vmux_cli-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vmux-cli
-Version: 0.5.5
+Version: 0.6.2
 Summary: Run anything in the cloud. Replace uv run with vmux run.
 Project-URL: Homepage, https://vmux.sdan.io
 Project-URL: Documentation, https://vmux.sdan.io

{vmux_cli-0.5.5 → vmux_cli-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vmux-cli"
-version = "0.5.5"
+version = "0.6.2"
 description = "Run anything in the cloud. Replace uv run with vmux run."
 readme = "README.md"
 license = "MIT"
@@ -66,6 +66,12 @@ Issues = "https://github.com/sdan/vmux/issues"
 [tool.hatch.build.targets.wheel]
 packages = ["vmux"]
 
+[tool.hatch.build.targets.sdist]
+include = [
+    "vmux/**/*.py",
+    "vmux/**/*.md",
+]
+
 [tool.ruff]
 line-length = 100
 target-version = "py310"

{vmux_cli-0.5.5 → vmux_cli-0.6.2}/vmux/__init__.py

@@ -2,5 +2,5 @@
 
 from .core import run_command
 
-__version__ = "0.4.0"
+__version__ = "0.6.1"
 __all__ = ["run_command"]

vmux_cli-0.6.2/vmux/claude/skills/vmux/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: vmux
+description: Deploy 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
+
+```bash
+vmux whoami  # Check login status
+vmux login   # If needed
+```
+
+## vmux run
+
+```bash
+vmux run [flags] <command>
+```
+
+### Flags
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--json` | | Emit JSON events (for LLM/agent use) |
+| `--detach` | `-d` | Run in background, return session 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 |
+| `--no-bundle` | | Skip bundling local packages (faster for scripts) |
+
+### Flag Combinations
+
+Flags can be combined: `-dp 8000` = detached + port 8000
+
+```bash
+vmux run python script.py           # Streams logs, blocks
+vmux run -d python script.py        # Detached, returns session 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
+```
+
+### JSON Mode (for LLMs/agents)
+
+```bash
+vmux run --json -d python server.py
+# Returns: {"session_id": "...", "preview_urls": {...}}
+```
+
+## After Deploy
+
+Always give the user:
+1. The **preview URL** (if port exposed) - format: `https://<session-id>.fullsend.dev`
+2. The **session ID**
+3. How to monitor: `vmux logs -f <session-id>`
+4. How to stop: `vmux stop <session-id>`
+
+## Other Commands
+
+```bash
+vmux ps                 # List running sessions
+vmux logs <session-id>              # All logs
+vmux logs -f <session-id>           # Follow logs in real-time
+vmux logs --tail 50 <session-id>    # Last 50 lines
+vmux logs -f --tail 50 <session-id> # Last 50, then follow
+vmux logs --json <session-id>       # JSON output for agents
+vmux logs --json --tail 20 <session-id>  # Last 20 lines as JSON
+vmux exec <session-id> <cmd>                        # Run command in running session
+vmux exec --json <session-id> <cmd>                 # JSON output
+vmux exec --create <cmd>                        # Auto-create Modal sandbox, run command
+vmux exec --create --provider cloudflare <cmd>  # Auto-create Cloudflare sandbox
+vmux exec --create --gpu H100 <cmd>             # Modal with GPU
+vmux attach <session-id>    # Interactive tmux session (Ctrl+B,D to detach)
+vmux stop <session-id>      # Kill session
+vmux stop -a                # Stop all running sessions
+vmux debug <session-id>     # Show tmux status and processes
+vmux secret set KEY     # Store secret in keychain
+```
+
+## Agent Workflow
+
+For LLM/agent automation, use `--json` flags:
+
+```bash
+# Option A: Start a session explicitly, then exec
+vmux run --json -d -p 8000 python server.py
+# Returns: {"session_id": "abc123", "preview_urls": {"8000": "https://..."}}
+
+# Option B: Auto-create sandbox with exec --create
+vmux exec --json --create --gpu H100 "pip install torch"
+# Returns: {"session_id": "abc123", "stdout": "...", "exit_code": 0}
+
+# Check logs (last 20 lines)
+# Check logs (last 20 lines)
+vmux logs --json --tail 20 <session-id>
+# Returns: {"logs": "...", "lines": 20}
+
+# Execute more commands (reuse session ID)
+vmux exec --json <session-id> "python train.py"
+# Returns: {"session_id": "abc123", "stdout": "...", "exit_code": 0}
+
+# Stop when done
+vmux stop <session-id>
+```
+
+### Empty Sandbox (for interactive use)
+
+```bash
+# Provision empty sandbox (persistent until stopped)
+vmux run -d sleep infinity                    # Cloudflare
+vmux run -d --provider modal --gpu H100 sleep infinity  # Modal + GPU
+
+# Or use exec --create (provisions + runs command in one step)
+vmux exec --create "pip install torch"                    # Modal (default)
+vmux exec --create --provider cloudflare "apt install -y curl"  # Cloudflare
+vmux exec --create --gpu H100 "pip install torch"         # Modal + GPU
+```