tomaszboloz

FuelSwitch AI — AI skill for Claude Code

AI community

FuelSwitch AI — macOS menu bar app & floating HUD that monitors Claude Code, Codex and Gemini CLI usage limits in real time.

How to install FuelSwitch AI

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tomaszboloz/FuelSwitch-AI and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What FuelSwitch AI does

FuelSwitch AI — macOS menu bar app & floating HUD that monitors Claude Code, Codex and Gemini CLI usage limits in real time. Live fuel gauges, reset countdowns, and 1-click credential switching between multiple accounts. Local-only, no telemetry. Swift 6, SwiftUI + AppKit.

Alternatives in AI

Vibeproxy — Native macOS menu bar app to use your Claude Code & ChatGPT subscriptions with AI coding tools - no API keys n 3.3k ★
Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★
Syrtis — AI token usage & quota monitor for the macOS menu bar — native Swift, Liquid Glass, 3D contribution graph 368 ★

README

FuelSwitch AI - Codex, Gemini, Claude Usage Widget + Switcher Account

macOS menu bar app and floating HUD that monitors Claude Code, Codex, and Gemini CLI usage limits, with 1-click account switching.

[![CI](https://img.shields.io/github/actions/workflow/status/tomaszboloz/FuelSwitch-AI/ci.yml?branch=main)](https://github.com/tomaszboloz/FuelSwitch-AI/actions) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Platform: macOS](https://img.shields.io/badge/platform-macOS-black.svg)](https://apple.com)

[Features](#features) • [Installation](#installation) • [Architecture](#architecture) • [Security](#security) • [Contributing](#contributing)

Overview

FuelSwitch AI is a macOS menu bar app and floating desktop HUD for engineers running multiple accounts on **Claude Code**, **Codex**, and **Gemini CLI**. It tracks 5-hour and weekly quota windows per account, shows a live reset countdown for each, and lets you switch the active credentials for a CLI without leaving your terminal.

Created by [Tomasz Bołoz](https://www.damtox.pl). Inspired by Headroom AI.

Features

1-click CLI switching — swap active credentials for Claude Code (~/.claude.json + Keychain) and Codex (~/.codex/auth.json) without restarting anything.
Floating HUD — a draggable, always-on-top panel with the same live data as the main window, in expanded or compact layout.
Reset countdowns — every quota window shows exactly when it resets, not just the current percentage.
Local-only — account tokens live in ~/Library/Application Support/FuelSwitch/accounts.json (0600 permissions). No servers, no analytics, no telemetry.

Installation

Requirements

macOS 13 or later, Apple Silicon or Intel.
Xcode 16 / Swift 6 toolchain to build from source.

Build from source

git clone https://github.com/tomaszboloz/FuelSwitch-AI.git
cd FuelSwitch-AI
swift test
make app        # builds .build/FuelSwitch AI.app (ad-hoc signed