Git Console

The Git console provides a way to run Git commands from the command line. You can launch the console directly from ReadyAPI.

About

The ReadyAPI UI provides access to some of the most widely used Git commands, as described in the previous topics of the section. However, there are commands that cannot be performed via the UI. This is where the console proves to be useful: it allows you to run all Git commands.

ReadyAPI uses the Git Bash console. It is a Linux-based command line that has implementations for Windows and macOS. All the commands in Git Bash are identical on all the platforms.

Tip

For a reference on Git Bash commands, visit the https://git-scm.com/docs page, or run the git help command in the console.

Set up console

To set up the Git console:

  1. Click Git on the main toolbar.

  2. Click git-sandwich-button.png and select Setup Git Console:

    Setup Git console

  3. On the Git tab that opens, enter the path to the installed Git Bash console in the Path to Git console field. You can click the Browse button and browse for the file.

    Git integration: Path to Git console

  4. Click OK.

Set up console via the Git project menu

  1. Make sure your project is a composite project.

  2. Right-click a project node in the Navigator and select Git > Setup Git Console from the context menu:

    Git integration: Set up Git console

    — or —

    Select Project > Git > Setup Git Console from the main menu:

    Git integration: Set up Git console

  3. On the Git tab that opens, enter the path to the installed Git Bash console in the Path to Git console field. You can click the Browse button and browse for the file.

    Git integration: Path to Git console

  4. Click OK.

Launch console

To launch the Git console after setting it up:

  1. Click Git on the main toolbar.

  2. Click git-sandwich-button.png and select Open Git Console:

    Git integration: Launch Git console

The console will launch:

Git integration: Git console

Note

When you launch the Git console, the current working directory is set to the folder of the project from which you launched the console.

Launch console via the Git project menu

  • Right-click a project node in the Navigator and select Git > Launch Git Console from the context menu:

    Git integration: Launch Git console

    — or —

  • Select Project > Git > Launch Git Console from the main menu:

    Git integration: Launch Git console

Working with console

Below, you will find some examples of typical tasks that you can perform with the Git console.

Do the initial push to an empty repository

  • Create a new empty repository on GitHub. You can read about it here: https://help.github.com/articles/create-a-repo/.

    Important

    Do not initialize the repository with a README.

  • Launch the Git console in ReadyAPI. In the console, run the following commands:

    1. Initialize the working directory as a Git repository:

      git init

    2. Stage all the files in the working directory for a commit:

      git add .

    3. Commit the staged files:

      git commit -m "<Your commit message here>"

    4. Set the URL of the remote repository where the commit will be pushed:

      git remote add origin <Repository URL>

    5. Push the commit to the main branch of the remote repository:

      git push origin main
Commit and push to the remote repository

Launch the Git console in ReadyAPI. In the console, run the following commands:

  1. Stage all the changes in the working directory for a commit.

    git add -A

  2. Commit the staged files.

    git commit -m "<Your commit message here>"

  3. Push the commit to the remote repository.

    git push origin main
Update from the remote repository

Launch the Git console in ReadyAPI. In the console, run the following command:

git pull

Important

Updating the project from the remote repository using the Git console will not automatically refresh the project in ReadyAPI. To see the changes, you need to manually refresh the project by selecting Project > Refresh from the main menu or by right-clicking the project node in the Navigator and selecting Refresh.

Branch from main branch

Launch the Git console in ReadyAPI. In the console, run the following commands:

  1. Create a new branch named development and switch to it:

    git checkout -b "development"

  2. Push the new branch to the remote repository:

    git push origin development
Merge into main branch

Launch the Git console in ReadyAPI. In the console, run the following commands:

  1. Switch to the main branch:

    git checkout main

  2. Merge the development branch into the main branch:

    git merge development

  3. Push the changes to the remote repository:

    git push origin main
Change the URL of a remote repository

Launch the Git console in ReadyAPI. In the console, run the following commands:

  1. Get the name of the remote repository:

    git remote
> origin

  2. Change the URL of the remote repository:

    git remote set-url origin <new URL>

See Also

In this section:
© 2025
Publication date: