gitwtfhub

wtf is telescope?

cloudflare/telescope — explained in plain English

Analysis updated 2026-07-25 · repo last pushed 2026-07-24

294TypeScriptAudience · developerComplexity · 2/5ActiveSetup · moderate

TL;DR

Telescope is a command-line tool that tests your website's load performance in real browsers, capturing video, screenshots, and detailed timing metrics you can view in an interactive online dashboard.

Mindmap

mindmap
  root((repo))
    What it does
      Tests website load speed
      Records video of page load
      Captures screenshots and logs
    Browsers supported
      Chrome
      Firefox
      Safari and Edge
    Use cases
      Find why a page is slow
      Catch performance regressions
      Share visual load reports
    Tech stack
      TypeScript
      Playwright
      Astro
      Cloudflare infrastructure
    Outputs
      Video and screenshots
      Performance metrics
      Timing data files

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Test a URL across multiple browsers to compare load times and behavior.

REASON 2

Catch performance regressions by running Telescope in your testing pipeline after shipping new features.

REASON 3

Generate a visual shareable report showing exactly how a page loads with video and waterfall charts.

REASON 4

Diagnose why a specific page is slow by inspecting detailed timing data for every resource fetched.

What's in the stack?

TypeScriptPlaywrightAstroCloudflare

How it stacks up

cloudflare/telescopebasketikun/infinite-canvasharkirat1462/claude-code-cli
Stars294294294
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-24
MaintenanceActive
Setup difficultymoderatemoderatemoderate
Complexity2/53/52/5
Audiencedeveloperdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Installing the tool downloads browser binaries that take up roughly 700 megabytes of disk space.

Wtf does this do

Telescope is a tool that tests how fast your website loads and performs by running it through real web browsers. Instead of just giving you a load time, it captures a full picture of what happens when someone visits your page: a video of the load, a screenshot, performance metrics, console logs, and detailed timing data for every resource the browser fetches. It supports major browsers including Chrome, Firefox, Safari, and Edge, so you can see how your site behaves across different environments. At its core, it is a command-line tool. You install it, then tell it to test a specific URL with a specific browser. Behind the scenes, it launches a real browser instance, loads your page, and records everything that happens during that load. The results are saved as a set of files you can keep locally. There is also a companion web app hosted at telescopetest.io where you can upload those results and explore them through an interactive dashboard showing waterfalls, filmstrips, and metric breakdowns. This is built for developers, QA engineers, or performance teams who need to understand why a page is slow or how changes affect load behavior. For example, if your team ships a new feature and wants to verify it did not regress page load times across browsers, you could run it as part of your testing pipeline. It is also useful for anyone who wants a visual, shareable report of how a page loads rather than just raw numbers. The project is structured as a monorepo with two parts: the command-line testing tool and the web app for viewing results. The testing side relies on Playwright, an open-source browser automation framework. The web app is built on Astro and runs on Cloudflare's infrastructure. One thing to note: installing the tool also downloads browser binaries, which take up roughly 700 megabytes of space.

Yoink these prompts

Prompt 1
Install Telescope and run a performance test on https://example.com using Chrome, then explain the key metrics in the output files.
Prompt 2
Run Telescope against my staging URL in Chrome, Firefox, and Safari, and compare the load times and waterfall results across browsers.
Prompt 3
Set up Telescope to test my homepage URL after every deploy and fail the build if the load time exceeds 3 seconds.
Prompt 4
Upload my Telescope test results to telescopetest.io and walk me through how to read the waterfall and filmstrip views to find bottlenecks.

Frequently asked questions

wtf is telescope?

Telescope is a command-line tool that tests your website's load performance in real browsers, capturing video, screenshots, and detailed timing metrics you can view in an interactive online dashboard.

What language is telescope written in?

Mainly TypeScript. The stack also includes TypeScript, Playwright, Astro.

Is telescope actively maintained?

Active — commit in last 30 days (last push 2026-07-24).

How hard is telescope to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is telescope for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.