Skip to content

alexandervashurin/semaphore / .claude/skills/browse

browse

Flagged

Fast headless browser for QA testing and site dogfooding. Navigate any URL, interact with elements, verify page state, diff before/after actions, take annotated screenshots, check responsive layouts, test forms and uploads, handle dialogs, and assert element states. ~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a user flow, or file a bug with evidence. Use when asked to "open in browser", "test the site", "take a screenshot", or "dogfood this".

FileKindSize
SKILL.mdskill md22.8 KB
SKILL.md.tmplother4.1 KB
bin/find-browseother814 B
bin/remote-slugother572 B
scripts/build-node-server.shscript1.9 KB
src/browser-manager.tsscript20.7 KB
src/buffers.tsscript4.2 KB
src/bun-polyfill.cjsscript2.9 KB
src/cli.tsscript12.0 KB
src/commands.tsscript8.0 KB
src/config.tsscript4.6 KB
src/cookie-import-browser.tsscript15.3 KB
src/cookie-picker-routes.tsscript7.5 KB
src/cookie-picker-ui.tsscript16.4 KB
src/find-browse.tsscript1.7 KB
src/meta-commands.tsscript9.7 KB
src/platform.tsscript634 B
src/read-commands.tsscript11.5 KB
src/server.tsscript13.3 KB
src/snapshot.tsscript14.8 KB
src/url-validation.tsscript2.2 KB
src/write-commands.tsscript13.0 KB
test/bun-polyfill.test.tsscript2.9 KB
test/commands.test.tsscript65.6 KB
test/config.test.tsscript10.7 KB
test/cookie-import-browser.test.tsscript16.1 KB
test/cookie-picker-routes.test.tsscript7.4 KB
test/find-browse.test.tsscript2.0 KB
test/fixtures/basic.htmlother914 B
test/fixtures/cursor-interactive.htmlother883 B
test/fixtures/dialog.htmlother603 B
test/fixtures/empty.htmlother43 B
test/fixtures/forms.htmlother1.8 KB
test/fixtures/qa-eval-checkout.htmlother4.2 KB
test/fixtures/qa-eval-spa.htmlother3.2 KB
test/fixtures/qa-eval.htmlother1.7 KB
test/fixtures/responsive.htmlother1.4 KB
test/fixtures/snapshot.htmlother1.5 KB
test/fixtures/spa.htmlother638 B
test/fixtures/states.htmlother567 B
test/fixtures/upload.htmlother849 B
test/gstack-config.test.tsscript4.7 KB
test/gstack-update-check.test.tsscript19.3 KB
test/handoff.test.tsscript8.1 KB
test/path-validation.test.tsscript2.2 KB
test/platform.test.tsscript1.0 KB
test/snapshot.test.tsscript19.7 KB
test/test-server.tsscript1.7 KB
test/url-validation.test.tsscript2.4 KB

test/url-validation.test.ts

View on GitHub
import { describe, it, expect } from 'bun:test';
import { validateNavigationUrl } from '../src/url-validation';

describe('validateNavigationUrl', () => {
  it('allows http URLs', () => {
    expect(() => validateNavigationUrl('http://example.com')).not.toThrow();
  });

  it('allows https URLs', () => {
    expect(() => validateNavigationUrl('https://example.com/path?q=1')).not.toThrow();
  });

  it('allows localhost', () => {
    expect(() => validateNavigationUrl('http://localhost:3000')).not.toThrow();
  });

  it('allows 127.0.0.1', () => {
    expect(() => validateNavigationUrl('http://127.0.0.1:8080')).not.toThrow();
  });

  it('allows private IPs', () => {
    expect(() => validateNavigationUrl('http://192.168.1.1')).not.toThrow();
  });

  it('blocks file:// scheme', () => {
    expect(() => validateNavigationUrl('file:///etc/passwd')).toThrow(/scheme.*not allowed/i);
  });

  it('blocks javascript: scheme', () => {
    expect(() => validateNavigationUrl('javascript:alert(1)')).toThrow(/scheme.*not allowed/i);
  });

  it('blocks data: scheme', () => {
    expect(() => validateNavigationUrl('data:text/html,<h1>hi</h1>')).toThrow(/scheme.*not allowed/i);
  });

  it('blocks AWS/GCP metadata endpoint', () => {
    expect(() => validateNavigationUrl('http://169.254.169.254/latest/meta-data/')).toThrow(/cloud metadata/i);
  });

  it('blocks GCP metadata hostname', () => {
    expect(() => validateNavigationUrl('http://metadata.google.internal/computeMetadata/v1/')).toThrow(/cloud metadata/i);
  });

  it('blocks metadata hostname with trailing dot', () => {
    expect(() => validateNavigationUrl('http://metadata.google.internal./computeMetadata/v1/')).toThrow(/cloud metadata/i);
  });

  it('blocks metadata IP in hex form', () => {
    expect(() => validateNavigationUrl('http://0xA9FEA9FE/')).toThrow(/cloud metadata/i);
  });

  it('blocks metadata IP in decimal form', () => {
    expect(() => validateNavigationUrl('http://2852039166/')).toThrow(/cloud metadata/i);
  });

  it('blocks metadata IP in octal form', () => {
    expect(() => validateNavigationUrl('http://0251.0376.0251.0376/')).toThrow(/cloud metadata/i);
  });

  it('blocks IPv6 metadata with brackets', () => {
    expect(() => validateNavigationUrl('http://[fd00::]/')).toThrow(/cloud metadata/i);
  });

  it('throws on malformed URLs', () => {
    expect(() => validateNavigationUrl('not-a-url')).toThrow(/Invalid URL/i);
  });
});
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall