> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.itential.com/itential-platform/6/studio/projects/connect-to-git/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server. # Connect a project to Git > Connect Itential Platform projects to a Git repository for version-controlled management, tracking, and storage of project file changes. From within **Projects**, you can connect to a remote repository such as GitHub or GitLab and use fetch, push, pull, and clone operations to sync a local copy of a project with the latest changes made by other collaborators. A set of valid credentials is required to communicate with any remote repository. See also [Git Integration for Projects](/itential-platform/studio/projects/connect-to-git). ## Set up access tokens Before you use Git, add a GitHub or GitLab access token. #### Open User Settings Click the menu icon next to the Itential logo, then click your user name. The **User Settings** dialog opens. ![](/_fern-img/8e399d86bb87374b2427a27e88421075b2d079ae6164c32d0ad17c69e9c7d632.webp) #### Enter your email address Enter your email address. Standard formats such as `name@example.com` and `firstname.lastname@example.com` are accepted. #### Paste the access token Paste the access token into the appropriate GitHub or GitLab field. ![](/_fern-img/63848469512f69fa9bac39bc9fceaa3bc7f44e70b6788f85ab069ce61f53ab0e.webp) #### Save Click **Save**. **Related reading:** * [Managing personal access tokens — GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) * [Token overview — GitLab](https://docs.gitlab.com/ee/security/token_overview.html) ## Add credentials If you attempt to connect without tokens, the **Remote Connection** field shows an alert. Click **See User Settings**, add credentials, and save. ![](/_fern-img/593d42c7ab96285db6c85f5c1b4310f491f8e5b92aa9346fed97b91cfb75b1b6.webp)![](/_fern-img/7863691d9a496421d44cf29b74ade0d8d91903cb1e303e0188131ffb5afe67be.webp) ## Initialize a new repository 1. Open the **Projects** homepage and click **New Project +**. ![](/_fern-img/1bc949e2dabefe1c4b8fbaf9d18fa20085caefd15792c9c144b10bf696640672.webp) Hover over the **Git** icon in the toolbar and choose **Initialize a New Repository**. ![](/_fern-img/09f6de366d41a28b7d471134f1bc59777f9261e0739a413e196fc274a904bb66.webp) In the dialog: * Select a remote connection (tokens must be configured). * Enter the repository path and branch name. * Specify the path to a `project.json` file. Click **Initialize and Push**. ![](/_fern-img/dfd82893a1a24d180c74fd537630548d9650a6b3bc0cfa20e6a679aefcada175.webp) A success banner appears when initialization finishes. ![](/_fern-img/9b9368216df67770156de6cca31bb9c41bfc6b191f43c6935368fdc2db2fdbb7.webp) ## Connect an existing project Open the project, hover over the **Git** icon in the toolbar, and choose **Connect to Existing Repository**. ![](/_fern-img/3dd61df3c4148caa59b2c63d26b0db4b63ed06baf5d6a558913c7c257a3089ad.webp) Select a saved **Remote Connection** or enter new settings, then click **Connect**. A confirmation dialog offers **Pull Update**, **Push Changes**, or **Dismiss**. ![](/_fern-img/619732696fa704442fa7a61c10ea7a963089ccc3ded91139050f0785bb5be4ef.webp) ## Pull updates Open the project, hover over the **Git** icon, and click **Pull Update**. ![](/_fern-img/bf756bc01d594abec3c41e1f792a7324a95a277d88448b33d0793a3c8ac42c46.webp) A warning confirms that pulling will overwrite local changes. Click **Pull Update** to continue. ![](/_fern-img/58c15291821ff1fe70b66d0a54c000c3ee4ff93d475d9a9943a68d2b42e6e82b.webp) ## Push changes Open the project, hover over the **Git** icon, and click **Push Changes**. ![](/_fern-img/9952880a130e86021b29978cae3d3175a2b2dd0bed469c5e0c1364bf1f7b5a99.webp) The **Generate Push for Project** dialog shows: * Target branch and project (use **Change Target Branch** to switch). * **Commit Message** field. * **Project Version Change** section showing current and publish versions. * Table of version history, commit messages, authors, and destination branches. ![](/_fern-img/bc2924a488f996c36cd3abfb20f0a0aa3aa096e9e7f561a45cadabf82b69f889.webp) ### Change target branch Click **Change Target Branch** to select a different branch or type a new path. Add a commit message and click **Push**. ![](/_fern-img/93dda5e8cd6d83738297bdc8267f0ca2d79a51bbe1eda31215319ca072650be6.webp) ## Synchronize a branch A sync icon appears next to the branch name in the side panel when your local project is out of sync with the repository. Hover over the icon to see version details. ![](/_fern-img/f4648a0b9c45a5940b72e3e8634672cec3cb05d435f609d55176cc8d1eff932a.webp) If you try to push an update and the target branch is out of sync, a warning displays. If you continue, the target branch will be overwritten with the pushed update. ![](/_fern-img/aa2a4f7282b2e9a33b77c56a00b6787b5545bab25d0e9a7a994aba6d6bda8f13.webp) Make sure you are in sync with the remote branch before you begin working. If another user updates the branch while you are working, your push will overwrite their changes. **Pulling** will overwrite your local project and **Pushing** will overwrite the remote project. ## Manage a branch Open the project, hover over the **Git** icon, and click **Manage Branch**. ![](/_fern-img/f8e922927fee63340cd8174337afe2fd15f667aa9840ba3d30129d53b7cbcf25.webp) In the dialog, pick a branch from the dropdown or enter a new name. Click **Confirm**. ![](/_fern-img/c94b4a7b44cdeac4a0a8490274585ca901fe74103aca3134269942fada456545.webp) ## View version history Open the project, hover over the **Git** icon, and click **Project Version History**. A dialog shows the current branch and a table of version changes with commit messages. ![](/_fern-img/90005e383a8b48396b2b7ab515677a34956a93238faf26abf0acd98aed0c54b0.webp) ## Remove Git configuration Open the project, hover over the **Git** icon, and click **Remove Git Configuration**. ![](/_fern-img/d775e1c0fd641b7c3643e76ddb7bf6c99a9e0f485653163145e50ca9f8b1d752.webp) A warning dialog confirms removal of the project's Git configuration. After removal, you must re-initialize the project to share it on Git. Click **Continue** to proceed. ![](/_fern-img/547964603905bbdaf5e0fdc2ffa6a9ca4ea019a5e14f3f5d633df27a59327c5f.webp) ## Clone a remote project Click **Clone Remote Project** from the Projects homepage. In the dialog, enter: * Remote connection * Repository path * Branch name * Path to a `project.json` file Click **Clone Project**. A success banner appears in the upper-right corner and the cloned project appears in the Projects homepage list. ![](/_fern-img/d33c8cee14ed2b8c702866af28fb9d6ed66736cc03faa1c423f0f6da3a27d741.webp) > Connect Itential Platform projects to a Git repository for version-controlled management, tracking, and storage of project file changes.