Skip to main content
Git Lite is the default Git panel in the Code IDE, and it’s built around the commit. You pick your files, write a message or let DinoAI write it, and click Ship it. Git Lite commits, pushes, and opens the pull request page in your Git provider.
Prerequisites
  • A workspace with a connected Git repository.
  • The Admin or Developer role, which you need to use the Code IDE.
  • Git Lite turned on. It’s the default. If the status bar at the bottom of the IDE shows Switch to Git Lite, click it.
Estimated time: 5 minutes.

​
Steps

1

Open Git Lite

In the Code IDE, click the Source Control icon in the left icon strip. The badge on the icon counts your changed files. You can also click the branch name in the status bar.New to Git Lite? Click the binoculars icon (Take a tour) in the panel for a short animated walkthrough.
2

Create a branch

Click the branch picker. On your default branch, the picker adds (read-only) to the name, for example main (read-only). Type a name for your branch, then click Create branch “your-branch-name”.Git Lite creates the branch from the latest version of your default branch on the remote, switches to it, and pushes it to the remote. The picker shows Switching branch… while it works.To work on a branch that already exists, search for it in the picker and select it. Git Lite switches to it and pulls the latest changes from the remote.
Switching or creating a branch discards your uncommitted changes. If you have any, Git Lite asks you to confirm in an Undo all changes dialog. To keep the changes, click Cancel and commit them first.
Branch names can contain letters, numbers, -, _, /, (, and ). Git Lite replaces any other character, spaces included, with -. For example, feat orders.mart becomes feat-orders-mart.New branches start from your repository’s default branch. An admin can choose a different base branch in Settings > Git Repository > Default git branch.
3

Choose the files to commit

Edit your dbt™ project. Each file you change shows in the Changes list with a status letter: A (added), U (untracked), M (modified), R (renamed), or D (deleted). Click a file name to open it.Every file starts selected. Clear the checkbox of a file to leave it out of the commit, or use Select all to select or clear every file.
If you clear every checkbox, Git Lite commits all your changes.
To throw changes away, click Discard all changes… at the top of the list. When only some files are selected, the link reads Discard N selected… and discards only those files. Confirm with Sure, continue!. You can’t undo a discard.
4

Write the commit message

The Commit message… box shows at the top of the panel once you have changes. Type your message there. Or click Write commit, and DinoAI drafts the message from the selected files. Edit the draft before you ship it.You can also leave the box empty. Ship it then asks DinoAI for the message.
Write commit shows when DinoAI is available in your workspace. If DinoAI can’t draft a message, the panel asks you to try again. You can always write the message yourself.
5

Ship it

Click Ship it. Git Lite checks off each step as it goes:
  1. Draft commit message with DinoAI, only when the message box is empty.
  2. Commit & push: commits the selected files and pushes them to your branch on the remote.
  3. Open pull request: opens the new pull request page for your branch in your Git provider, in a new browser tab.
To commit and push without opening a pull request, click the arrow next to Ship it, then Commit & Push. This option needs a commit message. The panel checks off Stage your files, Commit, Sync with the remote, and Push to the remote.
If someone else pushed to your branch, your push fails and Git Lite shows the error from Git. Click Update branch to pull their commits. Git Lite then pushes yours. If their changes conflict with yours, resolve the merge conflicts first.
6

Create the pull request

Ship it opened the new pull request page in your Git provider (GitHub, GitLab, Bitbucket, or Azure DevOps), which compares your branch with your default branch. Add a title and a description, then create the pull request.To open the page again, click the arrow next to Draft PR with DinoAI at the top of the panel, then Open PR in browser.
7

Keep your branch up to date

The sync status under the branch picker shows Up to date on origin when you have every commit from the remote. When the remote has commits you don’t have, on your branch or on your default branch, it shows Update branch instead. When the new commits are on your branch, the button also counts them, for example Update branch · 3 behind.Click Update branch. Git Lite pulls your branch from the remote, then pulls your default branch into it. After each pull it checks for conflicts and pushes, and it checks off Pull the latest changes, Check for conflicts, and Push to the remote.Git Lite checks the remote every 2 minutes. To check now, click the refresh icon next to the binoculars. The refresh icon is off while you have uncommitted changes.
You can also update from the Explorer. When your branch is behind, the top of the Explorer shows Pull N changes and what you’re behind, for example Your branch is behind main. Click it to run the same update. If the update finds merge conflicts, resolve them in the Git Lite panel.
8

Undo your last commit (optional)

Click ⋯ (More Git actions) next to the refresh icon, then Revert last commit. The dialog shows the commit hash, linked to the commit in your Git provider, and the commit message. Click Sure, continue!.
Revert last commit deletes the commit and its changes, then force-pushes your branch. The commit also disappears from the remote branch, and its changes don’t come back as uncommitted changes. Use it only on a branch nobody else works on.
The option is off while you have uncommitted changes, and on the read-only default branch.
You’ll know it worked when the sync status shows Up to date on origin, Draft PR with DinoAI shows at the top of the panel, and your pull request is open in your Git provider. If Ship it stays off, you’re most likely on the read-only default branch, or merge conflicts are waiting. See Troubleshooting.

​
Troubleshooting

  • There’s no commit message box. You have no changes to commit. The panel shows Nothing to commit, or You’re on a read-only branch on your default branch.
  • Ship it is off. You’re on the read-only default branch, or merge conflicts are waiting. Create or switch to a branch, or resolve the conflicts.
  • Commit & Push is off. Type a commit message first. Only Ship it asks DinoAI for one.
  • The pull request page didn’t open. Click the arrow next to Draft PR with DinoAI, then Open PR in browser. If nothing opens, check whether your browser blocked a pop-up.
  • A Pull request message asks you to push your local branch. Your branch isn’t on the remote yet. Use Ship it or Commit & Push, then open the pull request again.
  • The refresh icon is off. You have uncommitted changes. Ship or discard them, then refresh.
  • Write commit doesn’t show. DinoAI isn’t available in your workspace. Write the message yourself.

​
Next steps

Resolve merge conflicts

Fix the conflicts that Update branch or a pull can bring in.

Delete branches

Prune your local branches after their pull requests merge.

Git Lite reference

Every control in the Git Lite panel.

Use Git Advanced

Stage, amend, and manage branches with full control.