Getting started
XiaoQi is a menu bar app. It counts the time you are actually active and covers the screen when you reach your work limit.
Requirements
macOS 14 or later. The current build is version 0.1 and has not been released or signed for distribution.
Launch XiaoQi
Open 小憩锁屏.app. XiaoQi appears in the menu bar and has no Dock icon. On first launch it stays ready until it sees keyboard or mouse activity, so it does not count time while you are away from the Mac.
Read the menu bar
The title looks like:
🐱 32:15 · 歇 232:15— active work time in the current stretch歇 2— two completed breaks today
The menu uses Chinese labels. This is what each one means:
| Label | Meaning |
|---|---|
| 开始 / 暂停 | Start / Pause |
| 立即休息 | Take a break now |
| 会议模式 | Meeting mode (30 / 60 / 120 minutes) |
| 结束会议 | End meeting |
| 今日休息 N 次 · 连续 N 天 | Today’s breaks and streak |
| 设置… | Settings |
| 打开日志 | Open the log file |
| 退出 | Quit |
Start, pause, and take a break now
- Active time starts accumulating when you use the keyboard or mouse.
- Pause freezes the accumulated time. The idle rule does not clear a manual pause; Continue resumes from the same point.
- Take a break now starts a break immediately, even before you reach the work limit.
Defaults
- Work: 55 minutes
- Rest: 5 minutes
- Idle pause: 120 seconds
- Launch at login: off
All four are adjustable in Settings. See Settings and stats.
Interface language
The current build uses Chinese interface labels; this page maps them to English. Interface localization is planned.