Git Clone (Git Folder)

Git integration in Yeedu allows users to clone repositories directly into their workspace. This enables users to work with version-controlled code, notebooks, and files without leaving the platform.

A repository can be cloned either with credentials (for private repositories) or without credentials (for public repositories).

Prerequisite: link the Git provider first

Before you can create a Git folder for a given host, the matching provider must be linked under Settings → Linked Accounts.

The Git Provider field on the Git Repository Information modal is not a static list. It's auto-detected from the host in the Git URL and then constrained to the providers you've actually linked. If the provider for that host isn't linked, the field won't offer it and the form can't be submitted.

See Git Credentials (Linked Accounts) for how to link an account.

Creating a Git Folder (Clone Repository)

1. Navigate to Workspace Files

• Go to Workspace → Files (/workspace/{workspaceId}/workspace-files/root).
• Click the ⊕ New button on the right-hand toolbar.

The New menu offers four entries:

Entry	Creates
Git Folder	A folder cloned and tracked from a Git repository
Folder	An ordinary workspace folder
File	An ordinary workspace file
Notebook	A notebook

2. Select Git Folder

Choosing Git Folder opens the Git Repository Information modal.

Field	Required	Control	Notes
Git URL	Yes	Text	Placeholder e.g., https://github.com/org/repo.git
Git Provider	Yes	Dropdown	Auto-detected from the URL host and limited to your linked providers
Git Branch	Yes	Text	Placeholder e.g., main
Folder Name	Auto-filled	Text	Placeholder e.g., my-project; filled in from the repository name (repo.git → repo)
Credential	Auto-filled	Read-only field with a refresh icon	Resolved from the matching linked account; not user-entered. A + Credential button sits beside it

Footer actions: Reset | Create Git Folder

3. How the fields resolve each other

The modal is driven by the Git URL. Typing a URL triggers three side effects:

1. Git Provider is derived from the URL host and filtered to the providers you have linked.
2. Folder Name is filled in from the repository name.
3. Credential is resolved from the linked account for that provider and shown read-only. Use the refresh icon to re-resolve it.

Observed behaviour with a single linked provider

With only GitHub linked under Settings → Linked Accounts:

Git URL host	Git Provider field
github.com	Valid; the only option offered is GitHub
gitlab.com	Turns red / invalid, and still offers only GitHub

caution

A gitlab.com (or other non-linked host) URL will not produce a GitLab option in the dropdown — it produces a validation error instead. Link that provider under Settings → Linked Accounts first; retyping the URL won't help.

4. Credentials

• The Credential field is automatically populated based on the Git URL and the linked account for that provider, or
• Click + Credential to create a new one inline.

note

If the repository is public, credentials are not required and the repository can be cloned directly.

5. Submit

Click Create Git Folder. Use Reset to clear the form.

Clone Progress Notification

While the repository is being cloned, the UI displays a progress notification:

Creating Git Folder in the background... This may take sometime

Users can close this notification by clicking the X button located in the top-right corner of the popup. Closing the popup does not interrupt the cloning process.

Git Folder Representation in Workspace

After the repository is successfully cloned, the Git folder appears inside Workspace → Files.

Git folders are visually distinguishable from regular folders:

• A distinct git-folder icon replaces the plain folder icon.
• A branch pill showing the checked-out branch name (for example main) appears next to the folder name.

Example:

my-repository (main)

The Files list columns are the same for Git folders as for ordinary entries: Name | Size | Created By | Modified By | Created Time | Modified Time | Actions (⋮).

tip

The bottom-left Workspace Usage meter on the Files page shows storage and file-count consumption (for example Storage 151.61 MB / 50 GB, Files 270 / 20000). Cloned Git folders count towards both. See Git Limitations.

Git Folder Actions

Git folders support additional Git-specific operations through the Action Menu (⋮).

Git

The Git option opens a popup that allows users to perform Git-related operations on the repository. This popup provides access to various Git repository operations such as listing branches, switching branches, creating a new branch, viewing file diffs (similar to git diff), and identifying file changes including Added (A), Modified (M), Deleted (D), and Renamed (R). It also allows performing common Git actions such as Pull, Commit, and Push directly from the UI.

See Git Operations for the full walkthrough.

View Logs

The View Logs option opens a popup that displays detailed information about the cloning process.

The popup includes the following sections:

Section	Description
Clone Status	Displays the status of the repository clone operation
Stdout	Shows standard output logs generated during the clone process
Stderr	Displays error logs if any occurred during the process
System Error Messages	Displays workflow-level errors encountered during cloning

If no system errors are present, the message "No workflow errors found" will be displayed.

The popup also includes the following actions:

• Refresh – Reloads the log output
• Copy Logs – Copies the log content to clipboard
• Download – Downloads the log file
• Close – Closes the popup window

Retry

The Retry option allows users to retry the clone operation if it fails.

Other Available Actions

In addition to Git-specific actions, Git folders also support the same file operations available in workspace files such as:

• Download
• Rename
• Move
• Copy
• Delete

For detailed information on these actions, refer to the Workspace Files documentation.

Workspace Files Actions

Summary

Git clone functionality enables users to bring repositories directly into the workspace environment. This allows seamless interaction with Git-managed projects while maintaining the same file management capabilities available within Yeedu.

note

GitHub is the only supported Git provider in v2.10.1, and therefore the only provider that can be cloned from. The GitLab and Bitbucket tiles under Settings → Linked Accounts are permanently disabled in this build; support for them is planned but not yet enabled.