Getting Started

This guide will walk you through the first steps of setting up an account, creating an organization, and pushing your first repository to VeloGit.

1. Create an Account

VeloGit is open to sign up — no invite needed.

1. Go to velogit.com and click Sign up free.
2. Complete the registration flow via the identity provider.
3. You’ll land on your dashboard, ready to create an organization.

2. Create an Organization

VeloGit is multi-tenant by design. Every repository belongs to an Organization.

1. Click New Organization from your dashboard.
2. Choose a unique name for your organization.
3. Once created, you’ll be redirected to your new organization’s dashboard.

3. Create a Repository

1. From your organization dashboard, click New Repository.
2. Provide a name and choose the visibility (Public or Private).
3. Click Create.

4. Push Your First Commit

VeloGit provides standard Git Smart HTTP endpoints. You’ll need a Personal Access Token (PAT) to authenticate your Git client over HTTPS.

Generate a PAT

1. Click your avatar in the top navigation bar.
2. Select Developer Settings from the dropdown.
3. Click Generate Token and copy it immediately — it will only be shown once.

Local Setup

In your local project directory:

git init
git add .
git commit -m "initial commit"
git remote add origin https://velogit.com/<your-org>/<your-repo>.git
git push -u origin main

When prompted for credentials, use any username (e.g., git) and your PAT as the password.

5. Explore the Ghost Workspace

Once you push, your configured AI agents will begin analyzing the changes.

1. Navigate to the repository in the UI.
2. Click the Ghost Workspace tab.
3. Review any generated Shadow Fragments.
4. Click Meld to apply a suggestion directly to your branch.