Skip to main content
Version: v2.10.0

Git Operations

We provide built-in Git capabilities that let users run common Git operations directly from the workspace UI. These operations help manage branches, track file changes, synchronize with remote repositories, and push updates, so you don't have to leave the platform to do any of it. They are available for Git folders inside Workspace → Files.

Opening Git Operations​

To access Git operations:

  1. Navigate to Workspace → Files
  2. Locate the Git folder
  3. Click the Action Menu (⋮)
  4. Select Git

This opens the Git Operations popup, where you'll find every repository-related action.

git-folder-workspace-view.png

Branch Management

List Branches​

We let users view all branches available in the repository. The branch dropdown displays the list of branches present in the Git repository, and users can select any branch from it to view that branch's contents.

list_branches.png

Switch Branch​

Users can switch between branches using the branch selector.

Steps​

  1. Click the branch dropdown
  2. Select the desired branch
  3. The repository switches to the selected branch

list_branches.png

note

You can't switch branches when there are uncommitted changes.

To switch branches, users must either:

  • Commit and push the changes, or
  • Discard the changes

Create Branch​

Users can create a new branch from the current branch.

Steps​

  1. Click the + Branch button
  2. Enter the new branch name
  3. Click Create

The new branch will be created using the current branch as the base branch.

Upon creation, the system automatically switches to the newly created branch.

create-branch-popup.png

Local Clone HEAD Commit​

Next to the Create Branch option, the UI displays the Local Clone HEAD Commit. This represents the current commit hash of the repository that is checked out in the workspace, which is the quickest way to identify the exact version of the repository currently in use.

local_commit.png

Repository Synchronization

Refresh​

The Refresh button reloads the repository status and updates:

  • Branch information
  • File change status
  • Repository differences

This helps ensure the UI reflects the latest repository state.

refresh.png

Pull Changes​

If the local repository is behind the remote repository, the UI will show the number of commits behind, and users can click Pull to fetch the latest changes from the remote.

pull.png

Steps​

  1. Click the Pull button
  2. The latest commits are fetched from the remote repository
  3. The local repository is updated

Merge Conflicts​

If merge conflicts occur during the pull process:

  1. Users must manually resolve the conflicts
  2. After resolving conflicts, click Mark as resolved

This completes the merge process.

File Changes and Diff Viewer

The Git interface displays file changes detected in the repository. The left panel shows all changed files, the right panel displays the file diff view, similar to the output of the git diff command, and selecting any file from the left panel brings up the detailed differences for that file.

single_discard.png

Git tracks the following file change types:

CodeMeaning
AAdded file
MModified file
DDeleted file
RRenamed file
!Merge conflict

Discarding Changes

If users don't want to keep certain changes, they can discard them.

Discard Options​

Users can discard:

  • Individual files
  • Selected files
  • All changed files

Methods​

Individual File

Individual files can be discarded directly using the Discard button available beside the file name.

single_discard.png

Selected Files

  1. Select the required files from the file list
  2. Open the Actions Menu
  3. Click Discard Selected Changes

All Files

  1. Open the Actions Menu
  2. Click Discard All Changes

discard_actions.png

Discarding changes restores the files to the last committed state.

Commit and Push Changes

We allow committing and pushing changes directly from the Git interface.

Users can choose to commit:

  • Selected files, or
  • All changed files

Steps​

  1. Select files to commit
  2. Enter a Commit Message (required)
  3. Enter a Description (optional)
  4. Click Commit & Push

The changes are committed locally and pushed to the remote repository.

git-commit-push.png

Summary

Git operations in Yeedu provide a seamless interface for managing repositories directly from the workspace environment. The key capabilities are listing and switching branches, creating new branches, viewing file differences, discarding unwanted changes, pulling updates from remote repositories, committing and pushing changes, and viewing repository status. You don't have to leave the workspace: these features cover the essential Git workflows in place.

note

We currently support Git operations for GitHub repositories. Additional Git providers may be supported in future releases.