Skip to content
Streamglass

v1.1.5 · Open source · macOS

Debug mobile traffic and live event streams.

Streamglass is a debugging proxy for your Mac. Capture HTTP and HTTPS from phones, simulators and Mac apps, watch SSE events as they arrive, pause any flow to edit it, and let your AI agent see the same traffic once you turn that on.

curl -fsSL https://salomo.dev/streamglass/install.sh | bash
  • ProtocolsHTTP · HTTPS · SSE
  • ClientsiOS · Android · Simulators · Mac
  • AgentsMCP · 75 tools
  • LicenseMIT · captures stay local

Live streams

Server-sent events, as they happen

Watch each event arrive with the gap since the previous one, and see exactly how a stream ended: finished by the server, dropped, or closed by the client.

  • Connecting → open → streaming → ended, with timings
  • Gap statistics and a delivery mark on every event
  • Edit or suppress single events with breakpoints
The SSE timeline for a finished stream, with a status pill, connection steps, stat tiles and a per-event table

Breakpoints

Pause it. Change it. Continue.

Hold a request, a response or one SSE event and edit it in a full JSON editor before it reaches the app. Untouched JSON keeps its original bytes.

  • Requests, responses and individual events
  • Rules live in folders you drag to reorder
  • Drop the connection to test failure paths

Timing

Know where the time went

Every capture splits into connect, TLS, request, server wait and download, so a slow screen points at the network or at the backend.

  • Server time apart from transfer time
  • Request and response sizes
  • Sort and filter by server time
The inspector showing a timing breakdown for a flight search request

Devices

Phones in three steps

Scan a QR code to install the certificate, set the proxy address shown next to it, then approve the phone when it first connects. Works with iOS, Android, simulators and emulators.

  • Auto-proxy file falls back to direct when Streamglass closes
  • adb reverse for USB and React Native
  • New devices wait for your approval, which lasts 7 days
The Connect a device dialog with a QR code for the certificate page as step 1 and the proxy address as step 2

Traffic rules

Point traffic anywhere

Map production to staging with its own session, rewrite headers and status codes, serve local files, block hosts and slow the network down.

  • Map Local, Map Remote, Rewrite and Block
  • Groups and folders you switch on and off together
  • Network conditioning per flow
The Map Remote tool redirecting a production API to staging

AI agents

Your agent sees what you see

A local MCP server lets coding agents list captures, read timings, watch SSE events live and manage rules, through the same engine as the app.

  • 75 tools, off until you turn the server on
  • Sending requests or redirecting traffic waits for your approval
  • Live SSE notifications while the app is open
The Agent (MCP) setup with the server running on its local address

Daily tools

Everything else you reach for

Scripts

JavaScript hooks rewrite requests, responses and events, written in a full code editor.

Sessions

Save captures as archives and reopen them later.

Compare & replay

Diff two captures, then edit and resend one.

Mocks

Turn a capture, even a timed SSE stream, into a fixture.

Custom fields & assertions

Show JSON values as table columns and check every response.

Codecs

Decode app-specific encrypted bodies to inspect them.

Download

Get Streamglass

Free for Apple silicon Macs. Everything runs locally; captures never leave your Mac.

Install or update with one command

Choose where to install: Applications, ~/Applications for managed Macs that block app installs, or any folder. The script checks the download's checksum, replaces an older copy and opens the app.

curl -fsSL https://salomo.dev/streamglass/install.sh | bash

Download the app

The DMG and ZIP are on the latest release. Builds are not notarized yet, so approve the first launch in System Settings → Privacy & Security.

Latest release · v1.1.5 ↗

Run from source

Needs Node.js 22.12+ and Python 3.12+. The launcher installs dependencies, starts the engine and UI, and opens the app.

git clone https://github.com/salomohutapea/streamglass && cd streamglass && npm run dev

Contribute

Build it with us

Streamglass is MIT licensed. Bug reports, ideas and pull requests are welcome.

  1. Open an issue

    Include the app and macOS versions, the device and a small synthetic reproduction. Never attach real tokens or captures.

    New issue ↗
  2. Fork and branch

    Work on a branch in your fork. Start with the development guide and the architecture notes for the area you change.

    Development guide ↗
  3. Open a pull request

    Describe the problem, the new behavior and the checks you ran. The Test check must pass and a code owner reviews it.

    Contributing guide ↗