workspace-explorer

# Workspace Explorer Provide secure, temporary access to your workspace via code-server (VS Code in browser) tunneled through Cloudflare. **Repository:** https://github.com/mrbeandev/workspace-explorer ## Installation ```bash git clone https://github.com/mrbeandev/workspace-explorer.git ``` ## Usage Run the start script with the workspace path: ```bash python3 {baseDir}/scripts/start_workspace.py /path/to/workspace ``` The script will: 1. Download binaries on first run (code-server + cloudflared) 2. Start code-server on localhost 3. Create a Cloudflare tunnel 4. Print the **public URL** and **password** directly to terminal (Note: Wait 15-30s for the URL to become active) Example output: ``` ============================================================ ✅ WORKSPACE READY! ============================================================ 🌐 URL: https://random-words.trycloudflare.com 🔑 Password: xY7kL9mN2pQ4 ============================================================ 💡 Share the URL and password with your owner. Press Ctrl+C to terminate the session. ``` ## Options ```bash python3 {baseDir}/scripts/start_workspace.py /path/to/workspace --port 9000 ``` | Option | Default | Description | |--------|---------|-------------| | `workspace` | (required) | Path to directory to serve | | `--port` | 8080 | Local port for code-server | | `--status` | (flag) | Check if workspace is running | ## Heartbeat Support This project includes a `HEARTBEAT.md` file. When installed as an OpenClaw skill, the agent will periodically check if the tunnel is active and remind you if it's left running for too long. ## Termination Press `Ctrl+C` to stop the session. Both code-server and the tunnel will be terminated. ## Security - Each session generates a unique cryptographically secure password - Tunnel URLs are temporary `.trycloudflare.com` domains - No ports need to be opened on firewall - Session ends when script is terminated