whatisgithub

What is gf-tui?

jagenaujagenau/gf-tui — explained in plain English

Analysis updated 2026-07-25

2TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A terminal app for searching Google Flights without a web browser. It runs in your command line and lets you look up, filter, and sort flights directly.

Mindmap

mindmap
  root((repo))
    What it does
      Search Google Flights
      Terminal text interface
      No web browser needed
    Search features
      One-way round-trip multi-city
      Filter by airline and price
      Autocomplete airport picker
    How it works
      Scrapes Google Flights
      Uses compact data format
      No browser automation
    Tech stack
      TypeScript
      Effect library
      OpenTUI library
      Bun runtime
    Setup
      Homebrew install
      Build from source
      Refresh airport data

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

What do people build with it?

USE CASE 1

Search and compare flights directly from the terminal without opening a browser.

USE CASE 2

Filter flights by airline, price, duration, and stops for trip planning.

USE CASE 3

Look up one-way, round-trip, or multi-city flight options quickly.

USE CASE 4

Use autocomplete to find and select specific airports while searching.

What is it built with?

TypeScriptEffectOpenTUIBunProtocol Buffers

How does it compare?

jagenaujagenau/gf-tui4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopervibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Easiest to install through Homebrew with a single command, building from source requires the Bun runtime.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

{"i":0,"repo":"jagenaujagenau/gf-tui","stars":2,"lang":"TypeScript","ok":true,"char_count":1332,"text":"gf-tui is a terminal application for searching Google Flights without opening a web browser. Instead of visiting the Google Flights website, you run a command in your terminal and interact with a text-based interface to look up flights. The project is written in TypeScript and uses two libraries: Effect for managing application logic and OpenTUI for drawing the terminal interface.\n\nThe tool supports one-way, round-trip, and multi-city flight searches. You can choose any cabin class and passenger configuration. Results can be filtered by airline, price, flight duration, and number of stops, with flexible sorting options. When typing a city or airport name, an autocomplete dropdown suggests matching airports using a bundled dataset from OurAirports. You select a suggestion with arrow keys and confirm with Enter, or type free text that resolves to the closest matching airport code.\n\nTo fetch flight data, the application scrapes Google Flights over HTTP using Protocol Buffers, a compact data format. This approach avoids browser automation, which tends to be slower and more resource-intensive. The project is organized into folders for the terminal UI, flight scraping services, domain types and validation, utilities like caching and rate limiting, and the bundled airport dataset.\n\nInstallation is available through Homebrew with a single command, or you can build from source using Bun, a JavaScript runtime. The README notes that the bundled airport dataset can be refreshed by running a script that regenerates the data. The project is open source under the MIT license.","error":null}

Copy-paste prompts

Prompt 1
I have gf-tui installed. Write a command to search for round-trip flights from JFK to LHR for 2 passengers in business class.
Prompt 2
Using gf-tui, how do I filter flight results to show only non-stop flights under $500, and what sorting options are available?
Prompt 3
Help me set up gf-tui on macOS using Homebrew and run my first one-way flight search from SFO to SEA.
Prompt 4
Write a Bun script to regenerate and refresh the bundled OurAirports dataset used by gf-tui for airport autocomplete.

Frequently asked questions

What is gf-tui?

A terminal app for searching Google Flights without a web browser. It runs in your command line and lets you look up, filter, and sort flights directly.

What language is gf-tui written in?

Mainly TypeScript. The stack also includes TypeScript, Effect, OpenTUI.

What license does gf-tui use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is gf-tui to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is gf-tui for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.