pair-agent

Generate a one-time setup key and session token to pair a browser with another AI agent.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/westn/gstack-pi-port --skill pair-agent-westn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pair-agent
Source: https://github.com/westn/gstack-pi-port/tree/main/port/gstack/pair-agent
Command: npx skills add https://github.com/westn/gstack-pi-port --skill pair-agent-westn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Pair Agent skill enables two AI agents to share browser access securely by generating a one-time setup key and a session token. The remote agent gets its own tab and a scoped session, so you can collaborate or delegate browsing tasks without exposing control to others.

Core Features & Use Cases

  • Secure one-time setup key that expires in 5 minutes.
  • Separate browser tabs for local and remote agents with isolated sessions.
  • Supports local (same machine) and remote (ngrok) deployment with automatic or manual tunnel setup.
  • Clear troubleshooting and status checks, including token lifetimes and rotation.

Quick Start

Run the pair-agent skill to generate a one-time setup key, then paste the printed instruction block into the other agent to begin browsing.

Frequently Asked Questions about pair-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I securely share browser access with a remote AI agent?

You pair a browser with a remote AI agent by generating a one-time setup key and a 24-hour session token, then paste the printed instruction block into the remote agent to begin browsing in an isolated tab.

Can I pair an AI agent to browse with me over a remote ngrok tunnel?

Yes, you can pair an AI agent remotely via ngrok tunnels, supporting both automatic and manual tunnel setup to provide the remote agent with a separate browser tab and scoped session access.

Do I need a gstack environment to run the remote browser pairing workflow?

Yes, a functioning gstack environment and the ability to run the pair-agent workflow are required to generate the setup keys and session tokens for secure browser access.

How long is the session token and setup key valid for remote agent browsing?

The one-time setup key expires in 5 minutes for initial pairing, while the session token provides the remote agent with scoped browsing access for 24 hours before requiring rotation.

Why does my remote AI agent pairing fail to establish a browser session?

Pairing may fail if the 5-minute setup key has expired or if the gstack environment is not functioning properly, requiring you to generate a new key and run the provided troubleshooting status checks.