vk-bridge

A CLI bridge to the Vibe Kanban MCP server. List projects and tasks, create and update tasks, list repos, and start workspace sessions—all from the command line or from your own scripts and bots.

Useful if you want to:

• Script or automate Vibe Kanban from the terminal
• Integrate Vibe Kanban with other tools (CI, chatbots, dashboards)
• Drive VK from MCP clients that can run subprocesses

Requirements

• Node.js 18+
• Vibe Kanban (the CLI spawns npx -y vibe-kanban@latest --mcp to talk to the MCP server)

Install & build

git clone https://github.com/CydeSwype/vk-bridge.git
cd vk-bridge
npm install
npm run build

Run via node dist/index.js <command> ... or link the bin: npm link then vk-bridge <command> ....

Commands

All output is JSON to stdout; errors go to stderr as { "error": { "message": "...", "code": "..." } }.

Command	Purpose
list-projects	List all Vibe Kanban projects
list-tasks --project-id <uuid>	List tasks (optional: --status, --limit)
create-task --project-id <uuid> --title <s> [--description <s>]	Create a task
get-task --task-id <uuid>	Get task details
update-task --task-id <uuid> [--title] [--description] [--status]	Update a task
delete-task --task-id <uuid>	Delete a task
list-repos --project-id <uuid>	List repositories in a project
start-workspace-session --task-id <uuid> --executor <name> --repos-json <json> [--variant <s>]	Start a workspace session (repos: [{"repo_id":"...","base_branch":"main"}])

Examples

node dist/index.js list-projects
node dist/index.js list-tasks --project-id <your-project-uuid>
node dist/index.js create-task --project-id <uuid> --title "New item" --description "From CLI"
node dist/index.js list-repos --project-id <uuid>

Use from scripts or bots

You can run vk-bridge as a subprocess and parse the JSON output. Example: wire it into a Telegram bot, Slack bot, or CI step so users can ask for “my Vibe Kanban projects” or “add a task to project X” and your bot runs the matching vk-bridge command and returns the result. The process must run where npx -y vibe-kanban@latest --mcp is available (same machine/user as your Vibe Kanban app).

License

MIT — see LICENSE.