Getting Started with CodeTogether

Login | Host | JoinLogout | Work | Help

CodeTogether allows you to host and join collaborative coding sessions from Eclipse, IntelliJ or VS Code. Hosts and participants don’t need to have the same IDE, and participants can join sessions using any modern browser too. This guide includes information to help you get started, regardless of which IDE you use. For additional information, refer to the Installation Guides for EclipseIntelliJ and VS Code.

Logging In

You can host a CodeTogether session without a CodeTogether account, and participants can join these sessions from a browser without logging in. However, you must log in to join a running session from your IDE. If you are on a CodeTogether Teams plan, you can manage your team, host and join team-restricted sessions, and gain access to features like terminal write support. Click here for more details on Teams support.

You can create an account on the website, or if you’re using Eclipse or IntelliJ, you have the option of registering from the login dialog. Be sure to join the Insiders Program for early access to new features and special offers.

To log in to CodeTogether, click the Log in link in the CodeTogether view, or use the Log in command/action.

Hosting a Session

You can host a pair programming session directly from your IDE. All CodeTogether sessions are end-to-end encrypted.

Note: For details on how your data is kept secure, refer to the Security page.

Starting a Session

In the CodeTogether view, click the Host New Session button.

CodeTogether Teams tip: You can also request an online team member to host a session. Click the Ask to host a session button or context menu action.

Alternatively, use any of the following IDE-specific options to start the session:

Eclipse


  • Select Help > CodeTogether > Start Hosting Session.
  • Use the Start Hosting Session command.
  • Right-click in the editor and select Start Hosting Session from the menu.
  • Select text in the editor, and then click Start from the annotation that appears below the selection.

IntelliJ


  • Select Tools > CodeTogether: Start Hosting Session.
  • Use the CodeTogether: Start Hosting Session action.

VS Code


  • Use the CodeTogether: Start Hosting Session command
  • Click CodeTogether in the status bar and select Start Hosting Session.

​Controlling Access to the Session

When you start a session, you get to control who joins the session and what control they have over it.

Approval

By default, the Authorize via prompt setting will not let users join a session unless the host explicitly authorizes them via a prompt that appears in the host’s IDE when a participant joins the session. If desired, the authorization can be persisted so returning users will not have to wait on authorization again.

CodeTogether Teams note: For SaaS Teams, this question only applies when non-team members join the session via an invite URL.  When signed in, team members never need authorization to join a session, other than a one-time authorization to enable end-to-end encryption between the host and the joining member. If you are using On-Premises, all participants joining via an invite URL require authorization.

Driving and Editing

Driving specifies who is allowed to navigate between files and make selections, while Editing controls who can make changes to code. Note that members who aren’t allowed to drive will not be allowed to edit either.

Limit Access (Teams only)

Select the Restrict session to team members checkbox to prevent non-team member participants from joining the session entirely. This option is currently not available to On-Premises users.

Note: Persisted authorizations can be reset on the CodeTogether preference page.

Stopping a Session

In the CodeTogether view under Hosting, double-click (or click in VS Code) Stop sharing or click the Stop Sharing button.

Alternatively, use any of the following IDE-specific options:

 

Eclipse


  • Use the Stop Session command.

IntelliJ


  • Select Tools > CodeTogether: Stop Session.
  • Use the CodeTogether: Stop Session action.

VS Code


  • Use the CodeTogether: Stop Sharing command.
  • Click In Session in the status bar and select Stop Session.

Inviting Users to a Session

In the CodeTogether view, double-click (click in VS Code) Invite others or click the Copy Invite URL button to copy the Invite URL to your clipboard. Share the Invite URL with others to have them join your coding session.

CodeTogether Teams note: Double-click (click in VS Code) Invite others to select team members to invite to the session. Alternatively, you can use the Invite to Session button (or context menu action) for each team member in the Your Teams node in the CodeTogether view. Even if you’re logged in to a team account, the Invite URL can still be used to invite users to a session, regardless of whether or not they are members of your team.

You can also use any of the following options to copy the invite URL to your clipboard:

Eclipse


  • Click the copy invite URL link at the bottom of an open editor (visible only when there are no participants).
  • If you start a session from selected text, click Invite URL from the annotation that appears below the selection.

IntelliJ


  • Click the copy invite URL link at the bottom of an open editor (visible only when there are no participants).
  • Use the CodeTogether: Invite action.

VS Code


  • When you start a session, the Invite URL is automatically copied to the clipboard.
  • Use the CodeTogether: Copy Invite URL command.
  • Click In Session in the status bar and select Copy Session URL to Clipboard.
Notes:
1. Participants can also invite users to a session using similar techniques.
2. The number of participants that can join a session will be limited by your CodeTogether plan.

Hiding Files and Folders

CodeTogether 2.1 introduced the ability to prevent participants from accessing certain files or folders in the session. To hide files and folders, create a .codetogether.ignore file in the root of the project. Simple wildcard based patterns can be used to match files and folders to exclude from the session. If the session is active, you must restart the session for changes to take effect.

Session Timeout

Sessions automatically timeout:

  • When no participant joins for 90 minutes
  • 45 minutes after the last participant leaves
  • After 90 minutes of inactivity

Joining a Session

As of CodeTogether 3.0, you can join a session from an IDE, in addition to using a browser. Whichever method you choose, you lose access to all shared projects when you leave the session or the session ends.

Joining from an IDE

Prerequisites

  • The CodeTogether plugin/extension must be installed in your IDE. Please see our installation instructions for EclipseIntelliJ and VS Code.
  • Join the CodeTogether Insiders Program. Use or create an account to join the Insiders Program. For the next few releases, IDE to IDE support will be available only to Insiders.

To join a session

In the CodeTogether view, click Join Remote Session and use the Invite URL that was shared with you.

CodeTogether Teams note: If logged in to a team, double-click (click in VS Code) a running session from the list under the Remote Sessions node in the CodeTogether view. If you’ve been explicitly invited to a session, you will also see an invitation pop up in your IDE—accept the invitation to join the session immediately. Click the by Invite URL link to join using an invite URL.

Alternatively, use any of the following IDE-specific options to join a session:

Eclipse


  • Select Help > CodeTogether > Join Remote Session.
  • Use the Join Remote Session command.

IntelliJ


  • Select Tools > CodeTogether: Join Remote Session.
  • Use the CodeTogether: Join Remote Session action.

VS Code


  • Use the CodeTogether: Join Remote Session command.
  • Click CodeTogether in the status bar and select Join Remote Session.
In the Join Remote Session dialog, paste in the Invite URL, and specify an identifiable name to join the session.

Note: If you are not logged in, you will be prompted for your user name and password.

Joining a session

The resulting workspace is slightly different based on which IDE you use to join the session:

  • Eclipse—A new CodeTogether project is created in your existing workspace. All projects shared in the session appear as individual nodes immediately under this project.
  • IntelliJ—You can choose to join the session from the current window or from a new window. Whatever you choose, the projects shared will appear as a top level nodes within the Project view.
  • VS Code—A new window is automatically opened with a CodeTogether workspace. The projects shared appear as top level nodes under this workspace.

Joining from a Browser

Open the Invite URL in a browser to join the session—participants still get a full-fledged IDE experience.

CodeTogether Teams note: If you are joining a teams hosted session, you can log in for access to team-specific functionality. If the session is restricted only to team members, logging in is mandatory.

Customizing the IDE Experience

When you open the Invite URL the first time, you are prompted to customize your IDE experience—choose the look and feel of your favorite IDE, and key bindings that you’re familiar with, for a smooth coding experience in the browser. You can change these settings every time you join a session; or, from within a session, select File > Settings > CodeTogether: Change IDE Experience.

Specifying Your Name and Joining

After opening the Invite URL in the browser (and customizing the IDE on the initial session), you are prompted for the name to use in the session. Type your name and click Join Now. To change your name during a session, click your name in the status bar or the CodeTogether view and type a new name—the name can be changed at any time, and is persisted across sessions.

Workbench Layout

Use the following options to adjust the layout to your liking:

  • Double-click on an editor tab to have it take up the entire browser window, and maximize your coding real estate.
  • Press Alt+Shift+C to collapse all side panels.
  • Select the View menu to access additional options to customize the workbench.

 Logging Out

To log out of CodeTogether:

Eclipse


  • Select Help > CodeTogether > Log out of CodeTogether.
    • Use the Log out of CodeTogether command.

IntelliJ


  • Use the Log out of CodeTogether action.

VS Code

 


Signing Out of Teams

If you have a CodeTogether Teams plan, instead of logging out, you can just sign out of Teams. When you sign out of Teams, you will no longer be visible to other team members who are currently online. Sessions you start will not be shown in the Remote Sessions node, but you are free to join sessions while remaining offline in Teams by joining via the invite URL.

To sign out of teams, use the Go Offline action or context menu action on the Connected node in the teams section of the CodeTogether view.

Once signed out of teams, you can use the Reconnect Now link to easily sign back into the team.

Working in the Session

If the host gives participants full access rights, each member determines whether they want to code alone or together. For more details, refer to Session Basics.

Because language smarts are provided by the host, participants have access to a number of intelligent features when navigating and editing in a session. For more details, refer to Participating in a Session.

Getting Help

To chat with our dev and support teams live on Gitter, select Help > CodeTogether > Chat on Gitter or visit https://gitter.im/CodeTogether-com/community/. To report issues, use our GitHub issue tracker.