skills.rest
Undertone0809
Undertone0809COMMUNITY
Explore all skills by this author →
GitHub

rudder-worktree-preview-maintainer

Start a health-verified temporary web preview for the current Rudder checkout.

280|30|Updated Mar 30, 2026
Search Tags:#tmux#health check#local development#postgres#launchctl#rudder#worktree preview
One-click install
npx skills add https://github.com/Undertone0809/rudder --skill rudder-worktree-preview-maintainer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rudder-worktree-preview-maintainer
Source: https://github.com/Undertone0809/rudder/tree/main/.agents/skills/maintainer/rudder-worktree-preview-maintainer
Command: npx skills add https://github.com/Undertone0809/rudder --skill rudder-worktree-preview-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, git, pnpm, curl, lsof, tmux, launchctl, and includes scripts (resource) components.

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

Frequently Asked Questions about rudder-worktree-preview-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a temporary Rudder preview server in the background?▼

You can get a temporary Rudder preview URL by executing the start_current_branch_preview.sh script, which launches an isolated background dev server using tmux or launchctl and health-checks the instance before returning the URL.

What does health-verified readiness mean for a local Rudder dev server?▼

Health-verified readiness means the script waits for the /api/health endpoint to respond and confirms the returned instanceId matches the current branch's isolated preview instance before signaling that the local URL is ready for use.

Can I use an external PostgreSQL database if the embedded Postgres fails to start?▼

Yes, you can use an external PostgreSQL database when the embedded Postgres cannot start, allowing the Rudder preview to initialize successfully while preserving branch-derived isolation for your local development environment.

Why does my isolated Rudder preview fail the readiness check?▼

Your isolated Rudder preview might fail readiness if the /api/health endpoint does not return the matching instanceId, in which case the script provides tmux capture hints and tails managed log files to help diagnose the startup failure.

Does this temporary preview approach disturb my normal pnpm dev workflow?▼

No, using this temporary preview approach does not disturb your normal pnpm dev workflow because it selects free ports and uses a branch-derived instance id to keep the background preview session completely isolated from your standard local development setup.

How do I clean up and stop the background Rudder preview session?▼

You can clean up and stop the background Rudder preview session by running the dedicated stop command that the script prints upon successful startup, terminating the isolated tmux or launchctl process without affecting other local services.

Related Skills

Explore More Software Engineering Skills→
Undertone0809Undertone0809
280

pr-local-preview-maintainer

Run GitHub pull requests in isolated local worktrees with preview URLs.

Community
Intermediate
wangqianCAIwangqianCAI

tmux

Inject keystrokes and capture pane output from tmux sessions.

Community
Intermediate
wtyler2505wtyler2505
1

devserver

Manage the ProtoPulse dev server lifecycle in tmux with health checks.

Community
Intermediate
Undertone0809Undertone0809
280

stop-rudder-dev-maintainer

Stop repo-local Rudder pnpm dev processes with SIGTERM and optional forced cleanup.

Community
Intermediate