rudder-worktree-preview-maintainer

What problem does it solve?

It solves the problem of needing to quickly verify changes in the current Rudder checkout via a browser-accessible temporary preview without keeping a foreground dev process running.

Core Features & Use Cases

• Temporary branch-based preview runtime: Starts an isolated Rudder dev server for the current branch using a derived instance id, a stable local URL, and a dedicated stop command.
• Health-verified readiness handoff: Waits for the /api/health endpoint and confirms the returned instanceId matches the preview instance before telling you the URL is ready.
• Pragmatic log and failure handling: Provides tmux capture hints and tails managed log files when readiness fails, and supports using external PostgreSQL when embedded Postgres cannot start.
• Use cases: Post-implementation handoff where you want to manually inspect a recently changed UI/workflow; situations where you want logs and cleanup; and cases where the normal pnpm dev surface should not be disturbed.

Quick Start

Run the current-branch preview and wait for a health-checked URL by executing: bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh