Quickstart
Install the CLI globally and deploy your first isolated environment in under 10 seconds.
npm i -g @hynaweb/stage
export HYNA_API_KEY="your_key_here"
hyna-stage up index.html
export HYNA_API_KEY="your_key_here"
hyna-stage up index.html
Authentication
HYNA-Stage requires an API key. We recommend setting it as an environment variable to prevent shell history leaks.
# In your .bashrc or .zshrc
export HYNA_API_KEY="hyna_..."
export HYNA_API_KEY="hyna_..."
CLI Reference
hyna-stage up <file>- Deploy a new environment.hyna-stage down <sandbox_id>- Destroy an environment early.hyna-stage up <file> --json- Output machine-readable JSON (perfect for AI agents).
Agent Integration
AI agents cannot read colored terminal text. Use the --json flag to get a strict JSON payload with standard exit codes.
{ "success": true, "url": "https://...", "sandbox_id": "vm_123" }
Preview URLs
Because we prioritize zero-config isolation, URLs are generic and cryptographically random (e.g., https://8000-a1b2c3d4.e2b.app). They expire in 1 hour. No custom domains are supported to prevent DNS propagation latency.
Security Model
Each deployment runs inside a dedicated Firecracker microVM. VMs have no access to the host network. Outbound traffic is strictly limited to standard package registries (npm, pip).