Skip to main content

vibe-link

Bridges a finished workspace (branch pushed) to GitHub. Finds or creates the PR, links it back to the vibe-kanban issue, and moves the issue to in_review on the board.

Invoke​

/vibe-flow:vibe-link <workspace_id>

Usually auto-invoked by vibe-ship after each workspace reports complete.

What it does​

  1. Verifies branch exists on origin
  2. Checks for existing PR via gh pr list --head <branch>
  3. Creates PR if needed (title, body from issue + FINAL REPORT)
  4. Moves issue to in_review (resolves name from .vibe-flow.yaml → statuses.in_review)
  5. Updates state.json with pr_url, pr_number, status: pr_open

vibe-link no longer writes a [vibe-flow] PR opened: marker into the issue description — vibe-kanban’s PR monitor auto-fills pull_requests[] / latest_pr_url on the issue every 60s, so the marker would be a duplicate source of truth.

Optional CI wait​

If skip_ci_wait: false, watches the first CI run and routes to vibe-dispatch-fix if it fails.

Idempotent​

Running twice won’t duplicate PRs — gh pr list --head <branch> is the dedup gate. Re-transitioning to in_review when already in_review is a safe no-op.

Full reference​

skills/vibe-link/SKILL.md on GitHub →