Basic Syntax

The GitCentric CLI commands are executed as SSH remote commands, which require that you have an SSH client installed. The syntax for a GitCentric CLI command executed from SSH is:

ssh -p <port> <user>@<host> gitcentric [<command>] [[<arg>]...]] [--help] [--]
<port> GitCentric port number, typically 29418.
<user>@<host> The SSH user account used with GitCentric (for example myusername@localhost).
<command> May be one of the following:
  • config-branch
  • config-repo
  • delete-repo
  • ls-repo
<arg> One or more arguments to pass to <command>. These vary based on command.
--help, -h Displays the on-line help for the current command. Specifying --help with no other arguments (for example, gitcentric --help) returns a list of all available sub-commands.

Specifies that the rest of the command line is to be considered arguments, not options. For example, if you need to pass a repo name that starts with - you would precede it with --. After using --, you cannot pass any further options on that command line.

For example:

...config-repo Repo1 Repo2 -- -Repo3 Repo4 -Repo5

Back to top

Spaces and Quoting

To include a space in arguments for a GitCentric SSH command, you must use quotes.

In addition, Microsoft Windows requires that you nest single quotes within double-quotes. In the example below, double-quotes are provided for the Microsoft Windows shell, and single-quotes are nested within the double-quotes for the SSH command-line parser.

C:\source\TestProject>ssh -p 29418 mylogin@localhost gitcentric
config-branch --branch refs/heads/master -p 1 -e 3 -s 2
-d "'xxxx yyyy'" --initialSync git TestProject

Back to top

CLI example

This example walks you through the entire process of creating a repository, cloning it, populating it with content, pushing, and finally mapping one of its branches to an AccuRev stream, all through Git, Gerrit, and GitCentric CLI commands.
  1. Create a repository with an initial empty commit:
    ssh -p 29418 yourUsername@yourServer gerrit create-project --empty-commit repoName
  2. Register the repo with GitCentric and associate it with an AccuRev Server:
    ssh -p 29418 yourUsername@yourServer gitcentric config-repo repoName
    -S -u syncUser -p syncUserPassword
  3. Clone the repo.
    git clone ssh://yourUsername@yourServer:29418/repoName repoName
  4. Change to the new clone’s directory and configure it:
    cd repo_tues2
    git config "Firstname Lastname"
    git config ""
    git config remote.origin.push refs/heads/*:refs/for/*
  5. Using your preferred text editor, create a file in the clone.
  6. Add, commit, and push the file:
    git add --all
    git commit --all -m"First commit"
    git push

    Note: This step creates branch master, which must exist before the next step.

  7. Map the master branch to a stream named agc_devel on the AccuRev Server:
    ssh -p 29418 yourUsername@yourServer gitcentric config-branch repoName
    -b master -s streamName -e /
  8. Display a listing showing the mapped repo:
    ssh -p 29418 yourUsername@yourServer gitcentric ls-repo

Back to top