Corewise

Understand what your Mac is doing, without giving up your data.

Website · Download beta · Report an issue

Corewise is a local-first macOS diagnostic utility for understanding performance, storage, battery, startup activity, thermal state, and recurring app issues. It leads with observable signals, explains their limits, and never claims that one number represents the health of your Mac.

No account. No backend. No analytics. No automatic cleanup.

Important

Corewise is now available as a public beta. Download the signed, notarized universal DMG from GitHub Releases. GitHub's automatic “Source code” archives are not installable app downloads.

What Corewise does

• Focused Check observes supported local signals when a Mac feels slow, hot, battery-hungry, or full, then returns a cautious explanation and one useful next step.
• Performance separates CPU activity, memory context, swap, and live process evidence instead of presenting duplicate rankings.
• AI Workloads attributes supported local tools such as Codex, Claude, Cursor, and Ollama while keeping app footprint, related local work, and shared hosts separate.
• Storage shows startup-volume headroom and can perform a read-only analysis after one optional Full Disk Access grant or a user-selected folder scope.
• System diagnostics cover safe battery basics, launch plist inventory, high-level thermal state, and user-selected crash report patterns where macOS exposes reliable data.
• Local reports copy a plain-language Summary or Markdown report without uploading files, stack traces, prompts, or project details.

Corewise deliberately avoids health scores, process killing, automatic deletion, private sensor APIs, hidden folder scans, and claims of exact parity with Activity Monitor.

Product tour

AI Workloads Separate direct app footprint, related local work, and shared hosts without pretending to count cloud agents.	Storage See volume headroom first, then start an explicit read-only analysis with reusable permission.

Install the public beta

1. Download Corewise-0.1.0-universal.dmg.
2. Open the DMG and drag Corewise into Applications.
3. Open Corewise normally. The app is signed with Developer ID and notarized by Apple.

SHA-256: 00444d9577db1b4708ab9ae6aa7a50bb55340b30bd5d978df2187ecb4d184389

Full Disk Access is not required to run Corewise. It is optional and used only when you explicitly start Full Storage Analysis. Beta feedback and reproducible problems belong in GitHub Issues.

Build from source

Requirements:

• macOS 14 Sonoma or newer
• Xcode 15 or newer, or compatible Xcode Command Line Tools
• Git

git clone https://github.com/roccodaffuso/Corewise.git
cd Corewise
script/build_and_run.sh

The script builds and signs a local development bundle at dist/Corewise.app, then opens it.

For the signed DMG workflow, Homebrew option, Gatekeeper requirements, and update strategy, see Installation and distribution.

Privacy and safety model

Corewise reads supported diagnostics on the Mac where it is running. It has no network client, telemetry SDK, account system, payment flow, or remote database.

Every diagnostic source is classified as:

• Live — read from a supported local macOS source.
• Planned — intentionally not implemented yet.
• Unavailable — not currently exposed with enough reliability.
• Avoided — intentionally excluded for safety, privacy, or product integrity.

Storage and crash-report details require an explicit user action. Corewise does not upload diagnostic data or perform destructive remediation. Read the full safety and privacy model and data-source matrix.

Development

Corewise is a dependency-free Swift Package Manager application targeting macOS 14+.

swift build
swift test
swift build -Xswiftc -strict-concurrency=complete -Xswiftc -warnings-as-errors
script/build_and_run.sh --verify
script/package_release.sh preview
# Requires a validated notarytool Keychain profile:
script/package_release.sh release --notary-profile corewise-notary

The app icon is reproducible from repository-owned drawing code:

swift script/generate_app_icon.swift

Useful project documents:

• Product principles
• Architecture
• Current project status
• Design system
• Roadmap
• Decision log

Contributing

Issues and focused pull requests are welcome during the public beta. Read Contributing and the Code of Conduct before participating. Please keep changes narrow, preserve the local-first and non-destructive constraints, and never attach diagnostic reports containing usernames, personal paths, process arguments, prompts, or private file contents.

Found a reproducible problem? Report an issue. Security vulnerabilities belong in the private reporting channel, not in a public issue. The issue link is also available in Corewise under Settings → General → Project & Support.

Before proposing a new diagnostic, document its public macOS source, failure mode, privacy boundary, and user-facing wording.

License

Corewise source code is licensed under the Mozilla Public License 2.0. MPL-2.0 uses file-level copyleft: modified Corewise source files distributed outside an organization remain available under MPL-2.0, while separate files can use other licenses. The Corewise name and logo are covered separately by the trademark policy.

Source files carry machine-readable SPDX-License-Identifier: MPL-2.0 notices. Public binaries include the complete license and a link to the corresponding source repository.

Project status

Corewise is in public beta. The permanent identity is Corewise, dev.corewise.Corewise, and corewise.dev. The exact notarized beta artifact passed local Gatekeeper plus clean ARM64 and Intel validation; external feedback is tracked through GitHub Issues before stable promotion.