Session
Sharing
Invite teammates into a live session. Everyone sees the same terminal output in real time.
Overview
Session Sharing lets you invite other Taskeract Pro users into a live agent session. All participants see the same terminal output in real time, and the host controls who can type into the terminal.
No direct network connection between participants is needed — everything is routed through Taskeract's relay server. All session data is end-to-end encrypted, meaning the relay server cannot read any of your data. Both host and guest must have an active Pro subscription.
Sharing a Session
Right-click a session in the sidebar and select Share Session..., or use the session context menu to reach the same option. A dialog opens with a generated invite code in XXXX-XXXX format along with a token.
Share the invite code and token with the person you want to invite. The session starts streaming immediately once the sharing dialog is opened.
Joining a Session
Open the Taskeract menu and select Join Shared Session..., or press Ctrl+Shift+J. Enter the invite code and token provided by the host.
On success, a new tab opens showing the host's terminal in real time. You start in read-only mode by default.
Write Access
Guests join in read-only mode — they can see all terminal output but cannot type. The host can grant write access per guest from the sharing dialog by toggling the Read-only / Read/Write button next to each guest's name.
Write access is only active while the host is viewing the shared session. If the host switches to a different tab, guest writes are blocked until the host returns.
Managing Guests
The sharing dialog shows all connected guests with their display name. From here you can:
- Toggle write permissions — switch a guest between read-only and read/write access.
- Remove a guest — click the X button next to their name to disconnect them immediately.
The current guest count is shown in the session header badge.
Stopping Sharing
Click Stop Sharing in the sharing dialog, or delete the session (sharing ends automatically). All guests are disconnected immediately and see a "Session ended" message.
The session continues running locally — only the sharing connection is closed. Sessions also auto-expire after 24 hours.
What Guests Can See
Guests receive the full read-only view of the session, including:
- Terminal output — real-time streaming plus scrollback catch-up on join.
- Session logs — the full log panel contents.
- Git status and changes — current diff and staging state.
- Terminal history — previous commands and output.
- PR review data — review threads and comments.
- Issue details — linked issue information.
- Excavator findings — analysis results from the excavator.
All panel data is read-only for guests. Guests cannot commit, stage files, or edit issues.
Session Handoff
Session Handoff lets you transfer a session to another device or teammate. Right-click a session in the sidebar and select Hand Off Session.... You can optionally add a note describing where you left off.
Taskeract generates a handoff link that you copy and open on the receiving device. The entire session — including its worktree, branch, and terminal state — is transferred. This is useful when you want to continue working on a different computer or pass a task to a colleague.
Security
- End-to-end encryption — all session data is encrypted before it leaves your machine. The relay server cannot read your data.
- Invite tokens — each shared session has a unique, randomly generated token that expires with the session.
- Identity verification — both host and guest must be signed in with a valid Pro subscription. Each participant is verified independently.
- Rate limiting — join attempts are rate-limited to prevent abuse.
- Guest cap — up to 20 guests can join a single session.
- Auto-expiry — shared sessions expire automatically after 24 hours.
Limitations
- View-only panels — guests can see logs, git changes, PR reviews, and issues, but cannot make changes through those panels.
- Shared terminal only — guests with write access type into the same terminal the host sees. They cannot open separate terminals or run commands outside the shared session.
- No built-in chat — there is no messaging between participants. Use your own communication channel alongside the shared session.
- Pro required — both host and guest must be on the Pro tier.