Add per-tab session identifier (like TERM_SESSION_ID / ITERM_SESSION_ID) for external tool integration

[nzaytsev]

Pre-submit Checks

• I have searched Warp feature requests and there are no duplicates
• I have searched Warp docs and my feature is not there

Describe the solution you'd like?

Problem

Unlike MacOS Terminal.app ($TERM_SESSION_ID) and iTerm2 ($ITERM_SESSION_ID), Warp doesn't expose any unique identifier per tab in the environment. This makes it impossible for external tools to:

• Determine which specific Warp tab is currently visible/focused
• Focus a specific tab programmatically (e.g. when clicking a notification)

The workaround of checking the frontmost app via AppleScript (tell application "System Events" to get name of first process whose frontmost is true) only tells us that Warp is active — not which tab is
active.

Use case (concrete example)

Claude Code supports hooks — shell scripts fired on events like session completion. A Stop hook can send a desktop notification "Claude finished". The ideal UX: if the user is on a different tab, show the
notification; clicking it should focus the exact Warp tab with that session. This works perfectly in Terminal.app via $TERM_SESSION_ID + AppleScript, but is impossible in Warp.

Requested solution

One of:

1. Set $WARP_TAB_ID (or similar) as a unique env var per tab — analogous to TERM_SESSION_ID
2. Expose an AppleScript API to query/focus tabs by session identifier
3. Support a URI scheme: warp://focus?tab_id=XYZ

References

• apple script returns “stable” and not “warp” as application name #5143 (AppleScript returns "stable" instead of "Warp")
• Would be great if Warp as scriptable with AppleScript #3364 (AppleScript support request)

Is your feature request related to a problem? Please describe.

No response

Additional context

No response

Operating system (OS)

macOS

How important is this feature to you?

2

Warp Internal (ignore) - linear-label:39cc6478-1249-4ee7-950b-c428edfeecd1

None

[leesa-ui-w]

Thank you for bringing this to our attention. This issue is tracked under #8611    Please comment, 👍 upvote and subscribe there for updates. Closing as a duplicate.