managing-apps/scripts/vibe-kanban

Vibe Kanban Scripts

This directory contains all scripts specifically for Vibe Kanban integration.

Scripts

vibe-setup.sh

Purpose: Sets up the database and Docker services for a Vibe Kanban task environment.

Usage:

bash scripts/vibe-kanban/vibe-setup.sh [TASK_ID] [PORT_OFFSET]

What it does:

• Detects or generates a consistent TASK_ID for the worktree
• Auto-detects available port offset
• Creates Docker Compose file for the task
• Starts PostgreSQL and Redis containers
• Copies database from main repository
• Saves configuration to .vibe-setup.env

Configuration saved:

• Task ID
• Port offsets
• Database names
• All connection details

Note: This script runs in the "setup" section of Vibe Kanban.

---

vibe-dev-server.sh

Purpose: Starts the API and Workers processes (assumes database is already set up).

Usage:

bash scripts/vibe-kanban/vibe-dev-server.sh

What it does:

• Loads configuration from .vibe-setup.env (created by vibe-setup.sh)
• Verifies database is ready
• Starts API and Workers using start-api-and-workers.sh
• Displays logs with filtered warnings
• Shows API and Workers logs in real-time

Requirements:

• Must run vibe-setup.sh first to create the database environment
• Configuration file .vibe-setup.env must exist

Note: This script runs in the "dev server" section of Vibe Kanban.

---

cleanup-api-workers.sh

Purpose: Stops API and Workers processes for a specific task.

Usage:

bash scripts/vibe-kanban/cleanup-api-workers.sh <TASK_ID>

What it does:

• Stops API process (and child processes)
• Stops Workers process (and child processes)
• Kills orphaned processes
• Removes PID files
• Preserves log files for debugging

Features:

• Graceful shutdown (SIGTERM) with fallback to force kill (SIGKILL)
• Handles orphaned processes
• Works with Vibe Kanban worktrees
• Supports environment variables for TASK_ID

Note: This script is used by Vibe Kanban for cleanup operations.

---

Workflow

1. Setup Phase (Vibe Kanban "setup" section):

   bash scripts/vibe-kanban/vibe-setup.sh
   

   • Sets up database and Docker services
   • Creates configuration file

2. Dev Server Phase (Vibe Kanban "dev server" section):

   bash scripts/vibe-kanban/vibe-dev-server.sh
   

   • Starts API and Workers
   • Shows logs

3. Cleanup Phase (Vibe Kanban cleanup):

   bash scripts/vibe-kanban/cleanup-api-workers.sh <TASK_ID>
   

   • Stops all processes
   • Cleans up

Configuration Files

These scripts create/use the following files in the worktree:

• .vibe-task-id - Stores the persistent TASK_ID for the worktree
• .vibe-setup.env - Stores all setup configuration (ports, database names, etc.)
• .task-pids/ - Directory containing PID files and logs

Paths

All paths in these scripts are relative to the main repository:

• Main repo: /Users/oda/Desktop/Projects/managing-apps
• Scripts: scripts/vibe-kanban/
• Worktree: Detected automatically from current directory

Environment Variables

These scripts support the following environment variables:

• VIBE_TASK_ID - Task ID from Vibe Kanban
• VIBE_TASK_NAME - Task name from Vibe Kanban
• VIBE_WORKTREE_ROOT - Worktree root path (set automatically)