Vibranch
Guide

Getting started with Vibranch

First tree to first feature: about 10 minutes.

011. Prerequisites
  • ·Install Vibranch (Mac, Windows, or Linux).
  • ·Have one AI CLI ready — Claude Code, Codex, or Gemini CLI.
  • ·First tree to first feature: about 10 minutes.
022. Your first project

Create a project

Open Vibranch and create a new project. Point it at the folder where your code lives — new or existing.

Break your idea into a tree

One node = one thing you'd ask the AI to do at once. Add a node per requirement and nest the details underneath. Seeing the whole tree is how you catch gaps before the AI does.

TIPAlready have a Markdown spec? Paste the whole thing in — Vibranch turns it into a tree, splitting a new node at each # heading.

Attach images or references to nodes (optional)

Drop a screenshot, mockup, or reference onto any node. It travels with the prompt when you send it.

033. Send to your agent

Send the prompt

Hit Send on a node. Vibranch turns it into a clean Markdown prompt (attached images included) and sends it to your AI CLI in the terminal — Claude Code, Codex, or Gemini CLI.

Run in parallel, get completion alerts

Send different branches to different agents at the same time. Vibranch pings you when each one finishes, so you don't have to watch the terminals.

044. Track progress

Set status: In progress / Testing / Done

Color-code each node as you go. At a glance you always know what's built, what's being tested, and what's still missing.

All Done = your MVP

When every node is green, the spec you started with is shipped. That's your MVP.

055. Troubleshooting
Agent won't connect
Make sure your AI CLI (Claude Code, Codex, or Gemini CLI) is installed and runs on its own in a terminal first. Vibranch drives the CLI you already have.
Prompt won't send
Check that a node is selected and your agent's terminal is open and ready for input. Re-send once the agent is back at its prompt.
Something else?
If you're stuck, don't leave quietly — ask in Discord and we'll help.

Join our community

Hop into our Discord to share feedback and connect with other users and teams.

Back to home