Gaalbu

Tokidachi — Development skill for Claude Code

Development community

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

How to install Tokidachi

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

What Tokidachi does

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

Alternatives in Development

OpenAI Codex CLI — (Rust implementation) 67.8k ★
Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
Claude Auto Resume — A shell script utility that automatically resumes Claude CLI tasks when usage limits are lifted 732 ★

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