penrithbeacon/wcp-widget-markdown-editor repository overview

⁠WCP Widget: Markdown Editor

WYSIWYG markdown file editor with folder browser, multi-instance configuration, Publish to Web, and companion host agent for native filesystem access.

Specification: widgetcontextprotocol.com⁠ | Part of the Penrith Beacon WCP⁠ widget suite.

⁠Components

⁠Quick Start

docker run -d \
  --name wcp-widget-markdown-editor \
  -p 127.0.0.1:3748:3748 \
  -v markdown_workspace:/workspace \
  -e CONTAINER_NAME=wcp-widget-markdown-editor \
  -e WIDGET_PORT=3748 \
  --add-host host.docker.internal:host-gateway \
  --restart unless-stopped \
  docker.io/penrithbeacon/wcp-widget-markdown-editor:latest

⁠Docker Compose

services:
  wcp-widget-markdown-editor:
    image: docker.io/penrithbeacon/wcp-widget-markdown-editor:latest
    container_name: wcp-widget-markdown-editor
    ports:
      - "127.0.0.1:3748:3748"
    volumes:
      - markdown_workspace:/workspace
    environment:
      - WIDGET_PORT=3748
      - CONTAINER_NAME=wcp-widget-markdown-editor
      - AGENT_PORT=3749
    restart: unless-stopped
    extra_hosts:
      - "host.docker.internal:host-gateway"

volumes:
  markdown_workspace:
    driver: local

⁠Setup Guide

⁠Without companion agent

The widget UI loads, but file browsing requires the companion agent. Configure the agent first for full functionality.

⁠With companion agent

The wcp-agent-markdown-editor companion agent provides host filesystem access — browse your local drives from within the widget.

1. Download the macOS installer from the About component (GET /widget/agent/installer) or from GitHub Releases⁠
2. Run the .pkg installer — the agent starts automatically at login on 127.0.0.1:3749
3. The widget detects the agent automatically via host.docker.internal:3749
4. Open Settings → set the Root Folder using the Browse picker (shows your host filesystem)

The installer includes Uninstall WCP Markdown Editor Agent.app in /Applications/ for clean removal.

⁠WCP Request Headers

⁠Endpoints

⁠WCP Compatibility

⁠Technical Details

⁠Tags

⁠Changelog

⁠1.1.4 (2026-06-28)

• Path tooltip — hovering the truncated path label in the toolbar now shows the full absolute path in a native browser tooltip (title attribute kept in sync on every folder/file navigation)
• Copy Path button — new "Copy Path" button in the toolbar writes the current path to the clipboard; shows "Path Copied!" with a green success state for 3 seconds, then reverts; repeated clicks reset the timer

⁠1.1.0 (2026-06-10) — includes companion agent v1.0.2 installer

• Theme card — Settings page now shows 3 Penrith Beacon WCP built-in themes (Dark / Light / High Contrast) with "Built-in" badge; custom theme import from .wcpt files via checkbox modal with Select All / Deselect All
• Full-dashboard theme broadcast — selecting a theme in Settings posts wcp:theme-apply to window.top, updating the entire dashboard (podium, stave tabs, all widgets)
• WCP URL theme compliance — all four HTML templates now support both ?com.doc.widgetcontextprotocol=<base64> (query string) and #wcp-theme=<base64> (hash) forms
• WCP-compliant published SPA — POST /widget/publish generates HTML with baked-in active theme CSS vars and inline URL reception snippet; full var(--wcp-color-*) typography
• GFM table round-trip — TipTap Table/TableRow/TableHeader/TableCell extensions added; Turndown GFM plugin preserves pipe table format on save
• Encoding fix — agent file reads use utf-8-sig with latin-1 fallback, eliminating � replacement characters in files with non-ASCII content
• Agent-only file model — all file operations proxy through the companion agent; Docker volume stores widget state only
• Uninstaller app — Uninstall WCP Markdown Editor Agent.app bundled in agent .pkg for clean one-click removal
• Published page card — Settings page shows current publish state, source .md path, published timestamp, View and Unpublish actions
• Unpublish button — toolbar Unpublish button removes the published SPA; settings card updates immediately
• Manifest fixes — /wcp now includes type: "directory"; /widget/wcp now includes uuid and container fields
• Theme delete fix — replaced window.confirm() with a custom inline modal; confirm() is silently blocked in cross-origin iframes by Chromium/Electron 35; delete button now works correctly
• Companion agent v1.0.2 — (a) fixes UTF-8 write encoding, resolves HTTP 502 on non-ASCII saves; (b) uses os.scandir() + threaded=True, resolves blank sidecar caused by SMB cold-start latency exceeding browse timeout; (c) installer now shows a welcome screen with product name and version; (d) preinstall uses launchctl bootout + pkill to reliably stop any running agent before upgrade

⁠1.0.0 (2026-06-09)

• Initial release — full WCP 2.1.0 compliance, WYSIWYG editor, companion agent support, Publish to Web, WCP export

⁠Source

• GitHub⁠
• Widget Context Protocol⁠
• Penrith Beacon⁠