Quick Start

Get up and running with Light Git Client in minutes.

Opening a Repository

1. Launch the application
2. Click Open Repository on the welcome screen
3. Browse to a local Git repository folder and select it

The app loads immediately, showing your branches, changes, and commit history.

Cloning a Repository

1. From the welcome screen or an open tab, use the Clone option
2. Enter the remote URL and choose a local destination
3. The repository is cloned and opened automatically

Basic Workflow

1. View Your Changes

Unstaged and staged changes appear in their respective cards on the main screen. Click any file to view its diff.

2. Stage Files

• Click a file in Unstaged Changes to select it, then use Stage Selected
• Or click Stage All to stage everything at once

3. Write a Commit Message

Type your message in the Commit panel. The editor supports autocomplete for filenames and branch names — just start typing.

4. Commit

Click Commit to create your commit. Enable Commit and Push to push immediately after committing.

5. Push and Pull

Use the branch badges showing ahead/behind counts to push or pull. Click the ahead count to push, or the behind count to pull.

Navigating the Interface

The main view is divided into three columns of cards:

• Left column — Branches, worktrees, submodules, stashes, command history
• Middle column — Staged and unstaged changes
• Right column — Commit history and diff viewer

You can customize the layout by dragging cards between columns or hiding sections you don't use.

Multi-Tab Support

Open multiple repositories in tabs:

• Click the + button in the tab bar to add a new tab
• Drag tabs to reorder them
• Right-click or use the edit icon to rename a tab

See Tabs for more details.

Next Steps

• Explore the Features section to learn about everything the app can do
• Configure the app in Settings
• Set up Code Watchers to catch common mistakes before you commit