System health
CPU, memory, swap, disk, load, GPU, processes, and per-app memory — the macOS metrics already supported today.
Local-first
MIT license
npm package live
No telemetry
AI usage monitor · macOS
Your AI coding usage.
One local console.
StatusWeave is a local-first macOS monitor for membership and usage status from supported AI coding services — plus your Mac's system health — rendered on a localhost dashboard you control, with a read-only REST API your coding agent can query.
Side quest · agent-assisted install
One sentence to your agent.
Hand Claude Code, Codex, or Kimi a single prompt: read the install contract, run the npm install, and open the local monitor. You complete any official provider login yourself; the agent does not control your accounts and does not automatically discover every service you use.
prompt.txt — paste into your agent
Install and launch https://github.com/IndexFziQ/statusweave. First read AGENT_INSTALL.md in the repository, then follow the documented npm install (npx statusweave) to check the environment, detect Claude Code/Codex/Kimi, configure monitoring, launch, and verify. Reuse existing official CLI logins. If login, MFA, account selection, directory Trust, or a terminal [y/N] confirmation is required, stop and hand control to me. Never print or upload credentials in chat, logs, or to non-official domains. When finished, open http://127.0.0.1:8787 and report the actual availability of each provider.
// install shortcut; logins remain yours
Quest log · built-in sources
AI usage front and center. System health built in.
Supported AI coding usage appears after explicit setup of the providers you choose; Mac system health works immediately, no account required.
Claude usage
Limit windows when available, plus local token statistics from the supported Claude integration after opt-in.
Codex usage
Available quota windows and local token statistics after explicit Codex monitoring setup.
Kimi usage
Available membership-limit signals and local token statistics after explicit Kimi monitoring setup.
Read-only REST API
JSON endpoints on localhost that coding agents can read — values and percentages via simple GET responses and JSON paths.
Any local command
Turn command output into a monitored value with JSON paths or regex, as an opt-in custom source.
// AI service integrations depend on upstream behavior and may change as those services evolve.
Crafting · bring your own source
Mod your own console.
Add an HTTP endpoint or local command without rebuilding StatusWeave. Authenticated HTTPS JSON APIs keep their Bearer key in macOS Keychain — never in agent chat or configuration files.
~/.statusweave/providers.json
[
{
"name": "My API",
"type": "http",
"url": "https://api.example.com/quota",
"metrics": [
{ "label": "Daily", "kind": "percent",
"path": "$.daily.used_percent" }
]
}
]
Save points · delivery status
Available
Available
Beta · unsigned
What is playable today.
Honest checkpoint markers — no vaporware on this map.
HTML dashboard + REST
One npx command starts the localhost dashboard and read-only JSON endpoints your coding agent can query.
npm package
Published on npm. npx statusweave is the recommended one-line install; no clone or build step needed.
Floating window / DMG
Apple-silicon companion app for the local dashboard. Run npx statusweave first. If blocked, use System Settings → Privacy & Security → Open Anyway.
Shield stats · local-first
Local by default. External access is explicit.
Local by default
The dashboard and REST API bind to localhost. Enabled AI integrations contact only their provider domains; StatusWeave has no telemetry and no hosted backend.
External sources are opt-in
Custom HTTP and command sources stay disabled until you explicitly enable and configure them yourself.
New game · quick start
One command.
No hosted account, no database, no clone. Requirements: macOS and Node.js 18+. The first launch opens the dashboard automatically. Provider login may still require your own action.
Read the docs ↗terminal — zsh
$ npx statusweave # starts the local server and opens the dashboard # at http://127.0.0.1:8787 — add --no-open to skip the browser
Open source
MIT LICENSE
Free to play, free to build on.
StatusWeave uses the permissive MIT License. Use it privately or commercially, modify it, distribute it, and build on it — while preserving the license notice.