Skip to content
This repository was archived by the owner on Jun 1, 2026. It is now read-only.

wtfzambo/gastank

Repository files navigation

Warning

This project is archived. Use https://codexbar.app/ instead.

Gastank

Gastank is a tiny menu bar / tray app for tracking AI usage across providers.

The name is a pun on Steve Yegge's Gastown project.

Note

The first release supports Github Copilot. More providers will be added depending on need and how much I decide to care.


Install & Run

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/wtfzambo/gastank/main/scripts/install.sh | bash

Windows

iwr -useb https://raw.githubusercontent.com/wtfzambo/gastank/main/scripts/install.ps1 | iex

Downloads and runs the NSIS installer.

Manual download

Grab the latest release from GitHub Releases.

Run

Search for "gastank" in your App list and simply start it. It will immediately go in your system tray / menu bar.

Look for this icon: Gastank tray icon


CLI Usage

The binary includes a built-in CLI. Log in once via the GUI, then:

It's a bit janky at the moment, but it does its job, if for some arcane reason you need it.

gastank usage                  # fetch Copilot usage (JSON)
gastank usage github-copilot   # explicit provider name
gastank --version              # print version
gastank --help                 # show help

Development

Prerequisites

Tool Version Install
Go 1.25+ go.dev/dl
Node.js 20+ nodejs.org
Task 3.x taskfile.dev/installation
Wails CLI v3 alpha go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-alpha.74

Platform-specific dependencies:

macOS

Xcode Command Line Tools (ships with most setups):

xcode-select --install
Linux (Ubuntu/Debian)
sudo apt-get install -y build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev
Windows
  • MSYS2 or Git for Windows (provides bash for scripts)
  • NSIS (only needed for building the installer)
    choco install nsis
    
  • WebView2 runtime (usually pre-installed on Windows 10/11)

Quick start

# Install frontend dependencies
cd frontend && npm install && cd ..

# Run in dev mode (hot-reload)
task dev

Run tests

go test ./internal/...

Build

task build

Package (macOS .app)

task package
open bin/gastank.app

About

AI subscription usage meter in the menu bar / system tray

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors