Skip to main content

Usage

vibe clone <project-url> [directory]

Description

Clone a VibeHub project to create a local copy. This downloads all files and sets up the project for local development.

Arguments

project-url
string
required
The URL of the VibeHub project to clone. Example: https://vibehub.co.in/username/project-name
directory
string
Optional directory name. Defaults to the project name.

Examples

Basic Clone

vibe clone https://vibehub.co.in/username/my-project
This creates a my-project directory with all the project files.

Clone to Specific Directory

vibe clone https://vibehub.co.in/username/my-project ./custom-folder

Clone and Enter Directory

vibe clone https://vibehub.co.in/username/my-project && cd my-project

What Gets Cloned

ContentIncluded
All filesYes
Latest file versionsYes
VibeHub configurationYes
Commit historyMetadata only
AI promptsViewable in VibeHub web

Clone Workflow

Prerequisites

  • Must be authenticated with vibe login
  • Must have access to the project (owner or collaborator)

Output

A successful clone shows:
Cloning vibehub.co.in/username/my-project...
✓ Created directory: my-project
✓ Downloaded 47 files
✓ Configured VibeHub sync
Clone complete!

cd my-project to get started.

After Cloning

Once cloned, you can immediately:
# Enter the directory
cd my-project

# Check status
vibe status

# Make changes and push
# ... edit files ...
vibe push
The project is automatically connected - no need to run vibe init or vibe set.

Cloning Private Projects

For private projects, you must:
  1. Be logged in (vibe login)
  2. Be a collaborator on the project
If you try to clone a project you don’t have access to:
Error: Access denied. You don't have permission to access this project.

Error Handling

Project Not Found

Error: Project not found. Check the URL and try again.
Solution: Verify the project URL is correct.

Directory Exists

Error: Directory 'my-project' already exists.
Solution: Either:
  • Remove the existing directory
  • Specify a different directory name

Not Authenticated

Error: Not logged in. Run 'vibe login' first.
Solution: Authenticate with vibe login.

Clone vs Set

CommandUse Case
vibe cloneStarting fresh, downloading a project
vibe setConnecting an existing local directory to VibeHub
Use clone when you don’t have the files locally. Use set when you already have files and want to connect them.