Skip to content

Repository files navigation

K aji

The personal status and control layer for an AI-native Mac.

What matters today, one glance away.

中文 · Português · Español

GitHub stars macOS 13+, Apple Silicon MIT license Latest release

kaji-preview.mp4

What it is

Kaji brings the live state that matters to you into the Menu Bar. This includes AI quota, focus, goals, and your Mac.

Why the Menu Bar? It stays beside whatever you are doing: glance to know, hover for context, click to act. No app switch and no notification demanding attention.

Kaji starts small. Quota is on. Other modules are opt-in. One shell. Only the signals you choose to keep close.

Kaji is Japanese 舵 / かじ. It means rudder.

Read the vision.

Install

curl -fsSL https://raw.githubusercontent.com/blackblue-labs/kaji/main/install.sh | bash

Needs macOS 13+ (Apple Silicon), git, and swift. Clones the latest release tag, builds locally, clears quarantine, installs to /Applications.

No .app.zip on Releases (unsigned browser downloads trip Gatekeeper). Or run ./scripts/build-local.sh from a clone.

Modules

Module Default What you get
Quota on 5h / 7d usage, reset, token trend, cost estimate, providers
Work / Break off Focus timer, menu-bar countdown, break overlay
System off CPU / memory, disk categories, top processes
Goals off Today / Week / Vision / Schedule, notes, tags, heatmap
AI News off AI HOT Top 10, hover summaries, source context
Pet bridge Optional Navi via ~/Library/Application Support/Kaji/pet-state.json

Theme: Mono only (black / white / gray, light & dark).

Build

swift test
./scripts/build-local.sh

Links

License

MIT. See LICENSE.