staging-browser-localhost

Open an authenticated headless browser session for Aircall staging localhost testing.

2|2|Updated Jan 5, 2021
One-click install
npx skills add https://github.com/kentoje/dotfiles --skill staging-browser-localhost
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: staging-browser-localhost
Source: https://github.com/kentoje/dotfiles/tree/main/.config/claude/skills/staging-browser-localhost
Command: npx skills add https://github.com/kentoje/dotfiles --skill staging-browser-localhost

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables developers to open and control a headless browser session that is authenticated against Aircall's staging environment for localhost-based development and testing, eliminating manual login steps and ensuring consistent test context.

Core Features & Use Cases

  • Headless browser with staging credentials: Provides a reusable, isolated browser context for local apps.
  • Token-based authentication workflow: Retrieves staging tokens and uses them to complete an SSO callback flow.
  • Page interaction & verification: Supports taking accessibility snapshots and screenshots to validate UI behavior during local development.

Quick Start

  1. Get the Staging Token: Invoke the /staging-token skill to retrieve idToken and refreshToken from the JSON response.
  2. Navigate to SSO Callback with Tokens: agent-browser --session staging open "http://localhost:<PORT>/sso/callback?token=$ID_TOKEN&refresh_token=$REFRESH_TOKEN&redirect=$TARGET_PATH"
  3. Interact with Page: agent-browser --session staging snapshot -i -c agent-browser --session staging screenshot /tmp/staging-screenshot.png

Frequently Asked Questions about staging-browser-localhost

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

FAQPage Schema
How do I automate staging SSO authentication for localhost browser testing?

To automate staging SSO authentication for localhost testing, you retrieve staging tokens and navigate a headless browser session directly to the SSO callback URL using those tokens. This bypasses manual login by injecting credentials via token-based authentication.

Can I take screenshots and snapshots of a local app during automated browser testing?

Yes, you can take screenshots and accessibility snapshots of a local app during automated browser testing. Once the headless browser session is authenticated and navigated to the local page, use snapshot and screenshot commands to capture UI behavior.

What is the best way to test Aircall staging features on a localhost development environment?

The best way to test Aircall staging features on localhost is by opening a headless browser session authenticated with staging credentials. This approach retrieves staging tokens and routes them through the SSO callback to ensure a deterministic, isolated testing context.

Do I need a headless browser to run SSO callback workflows for local development?

Using a headless browser is required to run SSO callback workflows for local development in this context. The agent-browser tool relies on a headless session to securely retrieve tokens, navigate the callback URL, and maintain an isolated environment for testing.

Why does my automated localhost browser session fail to maintain staging authentication?

An automated localhost browser session may fail to maintain staging authentication if the initial token retrieval or SSO callback navigation is incomplete. You must ensure both the idToken and refreshToken are correctly passed to the callback URL to establish the session.

Does staging-browser-localhost support testing without manual login steps?

Yes, staging-browser-localhost supports testing without manual login steps. It eliminates manual intervention by programmatically retrieving staging tokens and executing an SSO callback flow to establish an authenticated headless browser session for local development.