Repository navigation
feat(os-vitals): alerts, live settings, pause, and the listing images - #10
Merged
Merged
Conversation
A worker that samples CPU from node:os, an HTML panel with the Overview CPU card, a status bar item, and the command that opens the panel through Orca's CLI. The manifest already declares the final access: two capabilities, one panel, one command, one status bar item. Unit tests and the smoke test live outside the plugin folder, so they are not installed. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker reads memory from vm_stat and sysctl, the process list from ps, and core kinds from ioreg. Process CPU comes from CPU time between two readings. The panel gains the memory card, the top processes card, and a sortable, filterable process table with a details drawer. Processes are read only while a view shows them. Measured cost is about 1.2% of one core with the Overview open and 0.16% in the background. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker sends the signal only after reading the process again and matching its start time, owner and name. It refuses the worker's own family, anything inside Orca's app bundle, and a protected set of system and Orca processes. The panel confirms in a dialog, and offers force quit when the process is still running five seconds later. Also fixes the ancestor walk, which stopped at the worker's parent, and re-sends a status bar update that Orca refused. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
CodeQL flagged the development server for returning an error's text to the client. It now logs the error and answers with a fixed message. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker reads network rates from netstat, disk activity and the GPU from ioreg, volumes from df, the battery and sleep blockers from pmset, and per-process energy impact from top. Energy is read only while its view is open. Rates are counted per interface and per drive, so a counter reset reads as zero. The Overview gains four cards. Each card opens a detail view, and every line chart has a crosshair and tooltip for pointer and keyboard. The Orca rule in the protected set no longer catches unrelated apps whose names merely start with the same letters. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
Linux reads /proc and /sys directly: memory with pressure, processes with CPU from tick deltas, network, disk, volumes, AMD and NVIDIA GPUs and the battery. Quitting works there through the same guards, and kernel threads are never offered. Windows and other systems get CPU and memory, and the panel says so once. Disk and GPU are now read on every second tick outside their own views, and energy every 10 seconds, which lowers the cost of the Overview and of the Energy view. Fixes the process table, whose rows collapsed when a filter was set. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker raises a memory alert after 30 seconds of critical pressure or use above the limit: one notification naming the largest process, then ten minutes of silence. The CPU alert changes only the status bar tone. All nine settings apply without a restart, and out-of-range values are ignored. The pause control stops the panel's sampling. The muted text now passes 4.5:1 on Orca's default surfaces, the tabs are a real tab list, and the Processes view keeps its footer above the details drawer at every width. Adds the icon, cover and four screenshots, generated from the panel code with sample data, and the final README and 1.0.0 changelog. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed and why
The last build step for OS Vitals 1.0.0. Nothing is released by this change: the catalog stays empty and no tag is made.
media/, generated from the panel's own code with sample data bytools/os-vitals/make-media.ts. The final plugin README and the 1.0.0 changelog.Plugin
os-vitals
Access changes
None. The manifest gains only
icon,coverandscreenshots. Execution level, capabilities, commands, panels, status bar items, modules and programs are unchanged.Tests
npm run check: formatting, policy, catalog and versions pass; 143 of 143 script tests pass.orca plugin validate plugins/os-vitals --json: valid, including the image sizes and formats.orca plugin test plugins/os-vitals --json: 23 of 23 worker tests pass, including one notification with the red tone, a refused notification, and all nine settings changed live.node --test 'tests/os-vitals/**/*.test.ts': 272 of 272 pass.Measured cost on an M4 Pro, worker plus the programs it runs: about 2.3% of one core with the Overview open, 0.13% with the panel closed, and none with background sampling off.
Not verified inside Orca itself, because its screenshot tool cannot click an HTML panel or switch theme while the window is visible: hover, keyboard and focus in the real panel, the light theme, and a real alert notification with its status bar tone. They are checked in the browser harness and with the test kit's mock host. The maintainer clicks through them by hand before the release.
Screenshots
The four listing screenshots and the cover are in
plugins/os-vitals/media/in this pull request.🤖 Generated with Claude Code
https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD