Switch or connect repositories

GitM works with one active repository at a time, but you can connect several and switch which one is active.

Prerequisites

• GitM installed and connected to at least one repository.
• For a new repository: your account allowlisted in GitMCloud.

This requires GitMCloud — see GitMCloud docs.

Connect another repository

1. Open Settings → Repository.
2. Choose Connect another repository…. This reuses the wizard's connect/create flow.
3. Connect to an existing repo or create a new one. It's added to your list and made active.

Switch the active repository

1. Open Settings → Repository.
2. Pick a previously-connected repository from the Active repository selector.
3. GitM makes it active and refreshes the task pane.

Switch safety check. If SolidWorks has open documents from the current repository, GitM warns you before switching — the same family of check as branch switching. Close those documents first so you don't edit files that are about to leave the active working set.

Expected result

• The task pane now shows the selected repository's files, branch, and history.
• Other connected repositories remain in your list, just not active.

Troubleshooting

Symptom	Cause	Fix
Switch warns about open documents	Open SW files from the current repo.	Close them, then switch.
The list has duplicate-looking entries	Each connect creates a repo entry; re-connecting the same repo adds another.	Pick the active one; duplicates are harmless but can be tidied in settings.
New connect blocked	GitMCloud access check failed.	Get allowlisted; see Connect to GitMCloud.

Known limitations

• One active repository at a time. Simultaneous multi-repo tabs are not built.
• The settings file can accumulate multiple entries for the same repository over time; this is cosmetic.