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

git clone https://github.com/mrbeandev/workspace-explorer.git

Usage

Run the start script with the workspace path:

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

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