---

name: workspace-explorer description: Securely share your workspace with your owner via a remote VS Code environment. Use when (1) the owner requests to view or inspect your working files, (2) you need to give the owner live access to browse your codebase, (3) the owner wants to install extensions or use IDE features to explore files, or (4) you need a temporary secure tunnel for remote workspace inspection. homepage: https://github.com/mrbeandev/workspace-explorer user-invocable: true

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