Session Sharing

Collaborate with anybody in a Warp terminal session, in real-time

Session Sharing allows multiple teammates to edit the input at the same time

Share a session

To start sharing:

  1. From the Command Palette, search for and select "Share New Session" or "Share Current Session".

  2. From the Pane header overflow menu, select "Start Session sharing"

  3. From the RIGHT-CLICK context menu, select "Share session..."

How to control a starting point for sharing

If you select to share a current session, you will be given the option to share without scrollback or from the start of the session. When you share access from the start of a session (with scrollback), collaborators will be able to view and interact with your entire session history including command outputs from before sharing was initiated.

If you initiate a shared session using Block actions, you will be given the option to start sharing from the selected block onwards. This option gives you the precision to select a specific block of output in your session history as the starting point, excluding all previous scrollback before that block.

Start sharing from a selected block onward or an entire session with or without scrollback

How to allow access to collaborators in your session

After starting a shared session, Warp will copy a link to your clipboard that you can share. Share links open the Warp's native app or the Web.

You can adjust who has view or edit access to your session and specifically:

  • Add emails to grant access

  • Allow anyone with the link

  • Allow anyone on your team

  • Revoke edit access from collaborators

  • Remove collaborators from the session

Update permissions through the share icon

When somebody accesses your shared session, they will be able to:

  • View your session in Warp including your command line input and output

  • Highlight blocks and text in your session

  • Request control to edit and enter commands in the sharer’s session

If granted access, collaborators can edit the input together in real-time and execute commands.

You can also:

  • Reference avatars and usernames for every collaborator who has access to your session

  • Jump to a collaborator’s selection by clicking on their avatar

Session Sharing Native to Web Demo

How to end a shared session

When you’re ready to end a shared session, click Share > Stop sharing to wrap up and close access for all collaborators.

Multiple shared sessions

You may share multiple sessions simultaneously. If you have multiple shared sessions, you will find Other shared sessions listed in the Share dropdown menu. You may also end multiple shared sessions at the same time with Share > Stop sharing all.

Switch between shared sessions or stop all shared sessions at once

Known limitations

  • Agent Mode blocks are not shareable during session sharing. Participants will be able to share regular shell commands that are run, but will not be able to share AI interactions (requested commands, AI blocks, etc.)

  • Secret redaction is not applied during session sharing.

  • There is a session size limit of 100MB per session, 1GB per user per day, and a maximum of 10 participants per session (excluding the sharer). These limits are subject to change.

  • Some of Warp's plans are limited to 5 shared sessions and the session limits do not reset. Upgrade to a paid plan to get unlimited sessions.

If you have any questions, please email [email protected].

Last updated

Was this helpful?