Workspace Explorer

SKILL.md

---
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

```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