Skip to content

About

Modular macOS menu bar utilities: clipboard, keep-awake for AI agents, second clock, window moves, USB-C cable info

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

T-Utilities

A modular macOS menu bar app (macOS 26+, Apple Silicon) that bundles the small utilities I use every day into one app. Each module can be turned on/off and reordered in Settings; disabled modules are stopped and released from memory.

Personal project. T-Utilities is built for my own use. It is public in case it helps someone else, but it is provided as is, without support, and features follow my own needs.

Module What it does Based on
Clipboard Clipboard history, search, quick slots (⌘1–0), OCR, Quick Look, optional paste-on-Return, plain-text paste (⌥⇧⌘V), resizable popover. Translation: hover an item (or ⌃⌥T for the latest one) to translate it in a speech bubble under the menu bar icon — images are OCR'd first; Korean ↔ English or other language pairs, custom guidelines; runs on the Claude / OpenAI / Gemini API (key in the Keychain) or a logged-in local CLI (Claude Code, Codex, Cursor) CopyNinja
Awake Keep the Mac awake manually or while AI coding agents (Claude, Codex, Cursor, Paseo) work — also with the lid closed idea from eclam
Clock Second time zone next to the menu bar icon (NY 00:33) —
Windows Maximize (⌃⌥↩), left/right half (⌃⌥← / →), fill height (⌃⌥↑, back with ⌃⌥↓), next/previous display (⌃⌥⌘→ / ←). Hold ⌥ and drag anywhere to move, right-drag to resize, double-click to maximize/restore. Drag a window's top or bottom edge to the screen edge to fill the height Rectangle, easy-move-resize
Cable USB-C port, cable and charger diagnostics WhatCable
Mouse Pointer speed/acceleration (slider or typed value, with the mice it applies to), side buttons → Mission Control / Show Desktop, wheel reverse/linear, Logitech battery (HID++) LinearMouse
Dictionary Global hotkey (⌥⌘Space) opens a resizable Naver / Daum dictionary panel (⌘1 / ⌘2 to switch) that remembers its size and place; off by default idea from allkdic
Stats CPU and memory at a glance; expands into a dashboard with disk, network (↓/↑) and optional GPU, plus top processes by CPU/memory. Measured only while the popover is open (no background polling), off by default idea from Stats
Remote Mac ↔ Mac remote control over Tailscale, with nothing else to install: turn on "원격 접속 허용" on one Mac, pick it from the popover list on another, and a window shows its screen (H.264, up to 30 fps, stream width selectable) and takes mouse and keyboard. Listens only on the Tailscale address, one session at a time, 10-minute idle timeout; lock screen works (type the password to unlock). Off by default —
Switcher Windows-style window switcher: hold ⌥ (or ⌘, replacing the macOS app switcher) and press Tab to pick a window from a thumbnail grid, including minimized ones. Arrow keys move, click or hover to pick, ⊗ closes a window. Thumbnails are captured only when it opens; off by default, experimental design reference only: alt-tab-macos (GPL-3.0, no code used)

The app updates itself from GitHub Releases (the popover's New update button; an arrow badge on the menu bar icon shows when one is available). Closing the popover returns focus to the app you were using.

Install: brew install --cask mordol/tap/t-utilities, or see INSTALL.md. What changed in each version: Docs/releases. Plan and design notes: PLAN.md.

Resource usage

Measured on 2026-10-20 on a MacBook Pro (M5 Max, macOS 27.0.1). The build was a Release build of v0.1.2 plus the on-demand Cable refresh. The app was idle, and each value is the median of three 120 s runs (Scripts/measure.sh).

Configuration Memory (phys_footprint) CPU (average)
No modules 12–13 MB ~0 %
One module 13–15 MB ≤ 0.02 %
All six modules 16 MB ~0.1 %

In use, memory grows once and then stays flat. The first time you open the popover adds about 30 MB, Settings about 19 MB, and the first OCR about 17 MB, which is SwiftUI/AppKit and Vision setup. With every feature used once, the app settles around 80 MB, and repeating those actions adds nothing. leaks reports only about 20 KB, all in a system XPC connection, none in the app's own code. Short spikes are expected:

  • OCR uses about 250 MB for 1–2 s.
  • Showing a popover or window adds about 200 MB of macOS-owned graphics memory for about 1 s with three displays. Finder shows the same spike.

Details: Docs/OPTIMIZATION.md.

Build

brew install xcodegen
xcodegen generate
xcodebuild -project T-Utilities.xcodeproj -scheme T-Utilities -configuration Release build

Builds are signed with a self-signed certificate named "T-Utilities Dev" so macOS permissions survive updates.

Each module is a local Swift package that can be turned off on its own. Before adding or changing a module, read Docs/MODULES.md: the rules that keep modules independent, and the steps for adding one. task test checks those rules and runs every package's tests.

License

MIT — see LICENSE. Third-party code and licenses: THIRD_PARTY_NOTICES.md.

About

Modular macOS menu bar utilities: clipboard, keep-awake for AI agents, second clock, window moves, USB-C cable info

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages