Tokidachi banner
Gaalbu Gaalbu

Tokidachi

Development community

Description

Tokidachi: a GNOME Shell companion for Claude Code and Codex usage limits

Installation

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

README

Tokidachi

This repository is the Linux/GNOME component of Tokidachi. It owns the platform-neutral Java collector, its versioned JSON contract, and the Linux host. The native macOS and Windows hosts consume that contract without reimplementing provider or credential parsing.

Tokidachi components

Component Scope Repository / downloads
Collector + Linux host Java collector and GNOME Shell widget tokidachi · Linux releases
macOS host Swift/AppKit/SwiftUI menu bar app tokidachiMac · macOS releases: TBD
Windows host WinUI 3/.NET tray app tokidachiWin · Windows releases: TBD

Rendering fixtures are available in [`fixtures/collector`](fixtures/collector/) for both native hosts to test against before a live collector is available.

A quiet GNOME Shell widget that shows Claude Code and Codex usage windows on Ubuntu. Providers are independent and only configured providers are displayed.

The widget has no taskbar icon and never appears in the window switcher or Overview. It stays below application windows, including maximized ones, and remains interactive when the desktop is visible. It supports GNOME 45–48 and targets Ubuntu 24.04 LTS. Unlike earlier releases, it is a normal interactive Shell element (not a click-through background layer): you can minimize it, drag it, resize it, and pick a theme, all with the mouse.

![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04%20LTS-E95420?logo=ubuntu&logoColor=white) ![GNOME](https://img.shields.io/badge/GNOME-45--48-4A86CF?logo=gnome&logoColor=white) ![License](https://img.shields.io/badge/license-MIT-green)

[!IMPORTANT] Tokidachi replaces the former AI Usage Widget name and uses the new GNOME extension UUID `tokidachi@gaalbu.github.io`. Existing installations need a one-time manual migratio