A lightweight, native macOS menu bar system monitor.
轻量原生 macOS 菜单栏系统监控工具。
|
English · 中文 · Releases · N1KO API
An AI vibecoding project by baogutang — built with N1KO API, product intent meets AI-assisted Swift/macOS development.
作者 AI vibecoding 作品，开发过程使用 N1KO API 大模型中转。
N1KO-STATE lives quietly in your menu bar and surfaces the metrics that matter — CPU, memory, GPU, network, disk, battery, temperatures, and fans — without turning your Mac into a second monitoring workload.
Left-click the menu bar icon for the live dashboard. Right-click for settings, about, and quit.
| Feature | Description | |
|---|---|---|
| 📊 | Live metrics | CPU cores, memory pressure, GPU utilization, disk I/O, network rates, battery health |
| 🌡️ | Sensors | Apple Silicon HID temperatures + Intel SMC fallback; peak temperature tracking |
| 🌀 | Fan control | Manual RPM with one-time admin authorization; temperature-based fan curve |
| 📈 | History | 24-hour trend charts (CPU / memory / network) at 30 s granularity |
| 🔔 | Alerts | Configurable thresholds for CPU, memory, temperature, disk space, battery |
| 🤖 | Agent Center | Claude, Codex, Gemini, Qwen, Qoder and more, with source-migrated session UI |
| 🏝️ | Agent Island | Compact, hover, detail, question, completion, sound-pack and mascot surfaces; public-API fullscreen reveal |
| 🌍 | Localization | English, 简体中文, 繁體中文 |
| ⚡ | Low overhead | Visibility-driven sampling; release calibration averaged 0.09% CPU in headless monitoring and Agent-core scenarios |
- macOS 12.0 (Monterey) or later
- Apple Silicon or Intel Mac
- Download
N1KO-STATE.dmgfrom Releases. - Open the DMG and drag N1KO-STATE to Applications.
- First launch (ad-hoc build): if macOS blocks it, run
xattr -cr /Applications/N1KO-STATE.appin Terminal. You can also right-click N1KO-STATE.app → Open.
Fan control installs a small privileged helper (one administrator password, once). Without it, fan speeds are read-only.
git clone git@github.com:baogutang/N1KO-STATE.git
cd N1KO-STATE
# Universal release + DMG (for distribution)
./build_app.sh --dmg
# Fast local build (host arch only)
./build_app.sh --native
# Smoke test after build
./build_app.sh --native --smokeOutput: build/N1KO-STATE.app · DMG: build/N1KO-STATE.dmg
Optional Developer ID signing:
export SIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)"
export NOTARY_PROFILE="your-notarytool-profile"
./build_app.sh --dmgSources/N1KOState/ App UI, monitors, settings
Sources/FanHelper/ Privileged fan-control daemon
Sources/SMCKit/ Vendored SMC client (MIT, beltex)
Localization/ en · zh-Hans · zh-Hant
Resources/ Info.plist, app icon
build_app.sh Build, sign, DMG, smoke test
The evidence-backed performance, native UI, Agent Center, unified settings, and notchless-fullscreen implementation roadmap lives in docs/roadmap/README.md. Future implementation tasks should start from the work package marked Next there.
- SMCKit — MIT © 2014–2017 beltex (vendored locally)
- Selected Apache-2.0 Agent Island source and sound assets — see
THIRD_PARTY_NOTICES.md
N1KO-STATE 是一款原生 macOS 菜单栏系统监控应用。它把 CPU、内存、GPU、网络、磁盘、电池、温度与风扇等关键指标收进菜单栏，自身占用极低，不会「监控你的 Mac 的同时再拖慢 Mac」。
左键点击菜单栏图标打开监控面板；右键打开设置、关于与退出。
| 功能 | 说明 | |
|---|---|---|
| 📊 | 实时监控 | CPU 核心、内存压力、GPU 利用率、磁盘 I/O、网速、电池健康 |
| 🌡️ | 传感器 | Apple Silicon HID 温度 + Intel SMC 回退；峰值温度追踪 |
| 🌀 | 风扇控制 | 手动 RPM（一次性管理员授权）；温度曲线自动调速 |
| 📈 | 历史趋势 | 24 小时图表（CPU / 内存 / 网络），30 秒粒度 |
| 🔔 | 告警通知 | CPU、内存、温度、磁盘空间、电量阈值可配置 |
| 🤖 | Agent Center | 支持 Claude、Codex、Gemini、Qwen、Qoder 等客户端与会话 |
| 🏝️ | Agent Island | 同源迁移紧凑、悬停、详情、提问、完成、音效包与宠物界面，并修复无刘海全屏展示 |
| 🌍 | 多语言 | English · 简体中文 · 繁體中文 |
| ⚡ | 低占用 | 可见性驱动采样；发布校准中监控与 Agent Core 场景平均约 0.09% CPU |
- macOS 12.0（Monterey）或更高
- Apple Silicon 或 Intel Mac
- 从 Releases 下载
N1KO-STATE.dmg。 - 打开 DMG，将 N1KO-STATE 拖入「应用程序」。
- 首次启动（ad-hoc 签名）若被系统拦截，优先在「终端」执行：
xattr -cr /Applications/N1KO-STATE.app。也可以右键 N1KO-STATE.app → 打开。
风扇控制需安装小型特权 Helper（仅需输入一次管理员密码）。未授权时风扇转速为只读。
git clone git@github.com:baogutang/N1KO-STATE.git
cd N1KO-STATE
# Universal 发布包 + DMG
./build_app.sh --dmg
# 本机架构快速构建
./build_app.sh --native
# 构建后冒烟测试
./build_app.sh --native --smoke产物：build/N1KO-STATE.app · DMG：build/N1KO-STATE.dmg
性能优化、原生 UI/动效、Agent Center、统一设置与无刘海全屏适配的证据化实施路线位于 docs/roadmap/README.md。后续实施任务应从其中标记为 Next 的工作包开始。
- SMCKit — MIT © 2014–2017 beltex（本地 vendored）
- 选用的 Apache-2.0 Agent Island 源码与音效资产 — 详见
THIRD_PARTY_NOTICES.md
Live star count above · chart may lag a few hours (GitHub image cache) · click chart for interactive view
上方徽章为实时 Star 数 · 趋势图因 GitHub 缓存可能延迟更新 · 点击图表可查看交互版
Title avatar may not render in README (GitHub blocks external images inside proxied SVG) · 标题处头像在 README 中可能无法显示
If this project helps you, a ⭐ on GitHub is appreciated · 若对你有帮助，欢迎点个 Star ⭐
N1KO-STATE is free and open source. If it saves you time or keeps your Mac running smoothly,
consider buying the author a coffee — every bit of support helps keep the project alive.
N1KO-STATE 免费开源。若它帮你省下了时间、或让你更安心地掌握 Mac 状态，
欢迎请作者喝杯咖啡，你的支持是我持续维护的动力 ☕
Scan with Alipay · 支付宝扫一扫 · Account: Nikooh
N1KO-STATE · v1.0.18 · Made for macOS power users who want clarity without clutter.