Collaborate on a session

Overwatch supports multiple operators recording into the same session simultaneously. Each operator works in a fully independent shell while commands from all contributors are captured and displayed together in a unified view on the platform.

This guide assumes you have already completed the setup steps in Run an Overwatch session and can run overwatch record successfully.


Join an active session

Multiple operators each run overwatch record in their own terminal and select the same session from the picker. Both operators can type and run commands simultaneously without blocking each other. Commands are captured separately and displayed together on the platform.

To join a colleague’s active session:

  1. Run overwatch record
  2. Select their session from the list when prompted
  3. Begin running commands

Your activity appears alongside theirs in the platform.


Shell hook prompt when opening a new terminal

If you open a new terminal window while a recording is already active, you will see:

Overwatch is recording session <id>. Enable command tracking hooks? [y/N]:

Enter y to have commands in that new terminal captured as part of the active session. The default is N, so pressing Enter without responding will opt out of tracking for that window.

If you want every new terminal to automatically join the active session, you can skip this prompt by setting auto_hook: true in your Overwatch config at ~/.method/overwatch/config.yaml.