Files
managing-apps/docs/VIBE_KANBAN_DEV_SERVER_SETUP.md
cryptooda ab08e0241b Update Vibe Kanban setup and scripts
- Added new entries to .gitignore for environment files and dynamically generated Docker Compose files.
- Updated documentation to reflect the new path for the Vibe Kanban dev server script.
- Enhanced task composition scripts to extract TASK_SLOT from TASK_ID, ensuring unique Orleans ports and preventing conflicts.
- Removed the old vibe-dev-server script, consolidating functionality into the new structure.
2025-12-31 04:36:20 +07:00

2.3 KiB

Vibe Kanban Dev Server Script Configuration

The Problem

Vibe Kanban runs the dev server script from a different working directory than expected, causing "No such file or directory" errors.

Solution: Use Absolute Path

In the Vibe Kanban dev server script field, use the absolute path to the wrapper script:

bash /Users/oda/Desktop/Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh

Alternative: If Relative Path is Required

If Vibe Kanban requires a relative path and you know it runs from /Users/oda/Desktop, use:

bash Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh

What the Wrapper Script Does

The vibe-dev-server.sh wrapper script:

  1. Uses absolute paths internally
  2. Changes to the correct project directory
  3. Handles task ID parameters
  4. Works regardless of Vibe Kanban's working directory
  5. Provides debug output to help troubleshoot

Testing the Script

You can test the script manually:

# From any directory
bash /Users/oda/Desktop/Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh TEST-001 0

Debug Output

The script includes debug output that shows:

  • Current working directory
  • Script path being used
  • Task ID and port offset

This helps identify if Vibe Kanban is running from an unexpected directory.

Troubleshooting

Error: "Script not found"

  1. Verify the script exists:

    ls -la /Users/oda/Desktop/Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh
    
  2. Check permissions:

    chmod +x /Users/oda/Desktop/Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh
    
  3. Try running it directly:

    bash /Users/oda/Desktop/Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh TEST-001
    

Error: "Cannot change to project root"

  • Verify the project root exists: /Users/oda/Desktop/Projects/managing-apps
  • Check directory permissions

Configuration in Vibe Kanban

Dev Server Script Field:

bash /Users/oda/Desktop/Projects/managing-apps/scripts/vibe-kanban/vibe-dev-server.sh

Health Check URL:

http://localhost:{port}/health

Port Detection: Vibe Kanban should detect the port from the script output or you may need to configure it manually.