Switch or connect projects

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

Prerequisites

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

This requires GitMCloud — see GitMCloud docs.

Switch the active project (header switcher)

The project name at the top of the task pane is a switcher, not just a label:

1. Click the @owner / project pill in the header (it shows a count badge when you have two or more projects).
2. Pick a project from the Projects list — the active one has a dot beside it.
3. GitM switches instantly and refreshes the task pane. No re-sign-in.

The same menu also has + Connect another project… and a Company admin portal ↗ link (opens the Tandem portal in your browser — see Sign in and your account).

You can still switch from Settings → Repository → Active repository if you prefer; it does the same thing.

Connect another project

1. Open the header switcher and choose + Connect another project… (or Settings → Repository → Connect another repository…).
2. Connect to an existing project or create a new one. It's added to your list and made active.

Switch GitHub account

Working under a different GitHub identity is uncommon, but supported:

1. Open the header switcher → Switch account… (or Settings → Authentication → Switch Account).
2. Confirm. GitM signs out of GitHub and reopens the setup wizard for the new account.

Check in first. Files you have checked out stay checked out to the current account — the new account can't check them in. GitM warns you (with the count) before switching. Check them in, or undo the check-out, first.

Switch safety

• Open documents. If SolidWorks has open documents from the current project, GitM warns you before switching — close them first so you don't edit files about to leave the active working set.
• Checked-out files. Switching projects keeps your checkouts (they're still yours) — GitM just shows a reminder. Switching accounts is what strands them (see above).

Expected result

• The task pane shows the selected project's files, branch, and history.
• Other connected projects stay in your list, just not active.

Troubleshooting

Symptom	Cause	Fix
Switch warns about open documents	Open SW files from the current project.	Close them, then switch.
New connect blocked	GitMCloud access check failed — the owner isn't enrolled.	Ask your Company admin to connect that GitHub owner; see Connect to GitMCloud.
Can't check in after switching account	Locks belong to the account that made them.	Switch back to that account to check in, or ask a manager to force-release.

Known limitations

• One active project at a time. Simultaneous multi-project tabs are not built.