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