Authentication

Connect your GitHub account to access repositories, organizations, and projects

Overview

TeamIDE uses GitHub’s secure Device Flow to authenticate without requiring you to enter passwords in the app. Once connected, you can:

• Access all your GitHub repositories
• Browse repositories from your organizations
• Use GitHub Projects for task management
• Push and pull changes with your credentials

Adding a GitHub Account

1. Go to Settings > Accounts
2. Click Add GitHub Account
3. A dialog appears with a device code (e.g., “ABCD-1234”)
4. Click Copy Code to copy it to your clipboard
5. Click Open GitHub to open the authorization page in your browser
6. Paste the code on GitHub and authorize TeamIDE
7. Return to the app - your account connects automatically

The Device Flow is GitHub’s recommended method for desktop apps. Your password is never entered in TeamIDE.

Organizations

When you connect your GitHub account, TeamIDE automatically detects all organizations you belong to. Each organization appears as a separate entry in your accounts list, marked with an “org” badge.

You can: - Filter repositories by organization using the Owner selector - Remove individual organizations without disconnecting your main account - Access private repositories you have permission to view

Switching Between Accounts

Use the Owner selector in the top bar to switch context:

Your selection is remembered and restored when you reopen the app.

TeamIDE Cloud

When you connect a GitHub account, TeamIDE automatically registers you with TeamIDE Cloud. This enables:

• Container environments for development
• Future collaboration features

This happens silently in the background - no additional sign-up required.

To view your TeamIDE Cloud status or sign out: 1. Go to Settings > TeamIDE 2. View your account information and membership date 3. Click Sign Out of TeamIDE to disconnect from cloud features

Signing out of TeamIDE Cloud does not affect your GitHub connection. You can continue using local features.

Removing Accounts

To remove a connected account:

1. Go to Settings > Accounts
2. Click the trash icon next to the account
3. Confirm the removal

Note: Removing a user account also removes all associated organizations. To keep the user account but remove an organization, remove only that organization.

Token Security

• Your GitHub credentials are stored locally on your device
• Tokens are never sent to TeamIDE servers (only to GitHub)
• You can revoke access anytime from GitHub Settings > Applications

Coming Soon

• GitLab authentication
• Bitbucket authentication

Related

• Code Module - Working with repository files
• Terminal Module - Terminal access to repositories

Changelog