docs / cli

CLI

The vibetree CLI is a thin client for a running VibeTree server: the desktop app's embedded server or a standalone one.

Install

The CLI ships with the repository. Build it once from a checkout:

$ git clone https://github.com/sahithvibudhi/vibe-tree && cd vibe-tree
$ pnpm install && pnpm build
$ node packages/cli/dist/index.js status

Add an alias to call it as vibetree from anywhere:

$ alias vibetree="node /path/to/vibe-tree/packages/cli/dist/index.js"

Commands

vibetree worktrees list                 # list worktrees
vibetree worktrees add <branch>         # create a worktree
vibetree worktrees remove <branch>      # remove a worktree
vibetree status                         # live sessions and agent states
vibetree run <branch> ["prompt"]        # start a session, launch the preset agent, send the prompt

Flags

Flag	Meaning
--project <path>	Project repository. Defaults to the current directory.
--server <url>	Server URL. Defaults to `$VIBETREE_SERVER` or http://localhost:3002.
--token <token>	Auth token for servers with auth enabled. Also read from `$VIBETREE_TOKEN`.
--agent <cmd>	Override the project's agent command. Applies to run only.
--delay <seconds>	Boot delay before sending the prompt. Default 4.

Example

# kick off an agent on a fresh branch and walk away
$ vibetree worktrees add fix-login-race
$ vibetree run fix-login-race "fix the login race condition, add a regression test"
# session keeps running server-side; open it in the app to watch