🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Workspace Explorer

by @mrbeandev

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.

Versionv1.1.5
Downloads2,523
Installs8
Stars⭐ 4
TERMINAL
clawhub install workspace-explorer

πŸ“– About This Skill


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
  • πŸ’‘ Examples

    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.

    βš™οΈ Configuration

    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 |