Quickstart

Once the agent is installed, sharing a terminal is one command.

Start a session

porthole host

Porthole spawns your shell and prints a link, a short code, and a QR code:

◈  Porthole — share your terminal, peer to peer

   Link     https://porthole.professorhusnain.com/s/p3rx-9kma
   Code     p3rx-9kma
   Status   ● waiting for viewer…

   [ QR code ]

   Press Ctrl-C to stop sharing.

Share it

Send someone the link, or have them scan the QR code from a phone. When they open it, their browser becomes the viewer — there is nothing for them to install. The moment they connect, the two of you are on a direct, encrypted peer-to-peer channel and the server steps aside.

Common variations

Share a view-only session that rejects all input:

porthole host --readonly

Require a password before anyone can join:

porthole host --password "correct horse"

Automatically close the session after a while, or after the first viewer leaves:

porthole host --expire 30m
porthole host --once

See the CLI reference for every flag.

End the session

Exit your shell (exit or Ctrl-D), or press Ctrl-C in the Porthole process. The session is torn down immediately and the link stops working.