qlodura
v1.6.0
Published
16GB cloud device straight from CLI into the browser via GitHub Actions + cloudflared
Maintainers
Readme
Qlodura
16GB cloud device straight from your CLI terminal into the browser via GitHub Actions + cloudflared.
Install
npm install -g qloduraUsage
Authenticate
qlodura authOr pass your token directly:
qlodura auth --token YOUR_GITHUB_PATStart a Device (TUI)
qlodura initLaunches an interactive TUI where you can choose:
- Account type (Personal / Organization)
- Operating System (Ubuntu, Debian, Fedora)
- Architecture (x64, ARM64)
- Repository (create new or use existing)
- Public/Private visibility
Start a Device (CLI Flags)
qlodura start --os ubuntu --arch x64 --repo my-cloud-device --publicOptions
--os Operating system base (ubuntu, debian, fedora) [default: ubuntu]
--arch Architecture (x64, arm64) [default: x64]
--org GitHub organization name (leave empty for personal account)
--repo GitHub repository to use (will be created if it doesn't exist) [default: qlodura-workspace]
--public Make repository public for unlimited free minutes [default: true]How It Works
authstores your GitHub token locallyinitorstartcreates a repository (if needed)- Pushes a GitHub Actions workflow that runs ttyd + cloudflared on a 16GB runner
- Triggers the workflow
- The workflow creates a cloudflared tunnel and commits the URL back to the repo
- CLI detects the URL and opens it in your browser
Nothing is downloaded to your local machine. The cloud device runs entirely on GitHub Actions runners in the cloud. You access it through your browser via a temporary cloudflared tunnel URL.
Requirements
- GitHub account with Actions enabled
- GitHub Personal Access Token with
repoandworkflowscopes - Public repository recommended for unlimited free minutes
Free Tier
- Public repos: Unlimited GitHub Actions minutes
- Private repos: 500 minutes/month (free account), 3000 minutes/month (Pro)
- Each session lasts up to 6 hours
Example
# Start a 16GB Ubuntu device in your org
qlodura start --org my-org --os ubuntu --arch x64 --public
# Interactive mode
qlodura init