coretend

<p align="center">
  <img src="Resources/Brand/Logo/coretend-app-icon-1024.png" width="160" alt="CoreTend app icon">
</p>

<h1 align="center">CoreTend</h1>

<p align="center"><strong>See what fills your Mac. Clear it safely.</strong><br>
Your whole Mac in one click, caches and developer files cleaned in one review, apps uninstalled completely — everything goes to the Trash, with Undo.</p>

<p align="center">
  <a href="https://github.com/ahmetbsbnr/coretend/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/ahmetbsbnr/coretend?sort=semver&color=2C6E35&label=release"></a>
  <a href="https://www.npmjs.com/package/coretend"><img alt="npm" src="https://img.shields.io/npm/v/coretend?color=2C6E35&label=npm"></a>
  <img alt="macOS 14+" src="https://img.shields.io/badge/macOS-14%2B%20·%20Apple%20silicon%20%2B%20Intel-0F2019">
  <img alt="Signed and notarized" src="https://img.shields.io/badge/Developer%20ID-notarized-2C6E35">
  <a href="LICENSE"><img alt="Apache 2.0" src="https://img.shields.io/badge/license-Apache--2.0-0F2019"></a>
</p>

<p align="center">
  <a href="https://coretend.ahmetbsbnr.com">Website</a> ·
  <a href="https://coretend.ahmetbsbnr.com/en/download">Download</a> ·
  <a href="CHANGELOG.md">What's new in 2.3</a> ·
  <a href="https://coretend.ahmetbsbnr.com/fr/index">Français</a>
</p>

<p align="center">
  <img src="Website/screenshots/home-en-dark.png" width="820" alt="CoreTend Overview">
</p>

---

## Four spaces

| Space | The question it answers |
|---|---|
| **Home** | How is my Mac, and what can I do now? The space CoreTend can give back, one button away. |
| **Space** | What takes the space? A map of your home folder, large files and exact duplicates. |
| **Clean** | What can I remove safely? 30 rules read at once — caches, logs, Xcode, simulators, npm, pnpm, Gradle, Cargo, Mail, AI tools and local models (Ollama, LM Studio), broken login agents, disk images — safe items ticked, one review, Undo. |
| **Apps** | Which apps take space or start on their own? Uninstall completely: the app and the files it left. |

History of every scan and move stays at the sidebar's foot.

## Around the Mac

- **Shortcuts and Siri:** Get Free Space, Get Space to Clear, Open CoreTend (read and open only).
- **Widget:** free space and what the last Clean found.
- **Finder:** right-click a folder › Analyze with CoreTend; or drop it on the Dock icon.
- **System features (optional):** tidy `/Library/Caches` and turn third-party system services on or
  off, delete a local Time Machine snapshot or rebuild the Spotlight index, through a small signed
  helper installed only when you turn it on in Settings › System.

## What CoreTend will never do

- **Erase your files for good.** Moves go to the macOS Trash after your review; CoreTend checks each
  item again just before, and Undo puts it back. The one exception is a local Time Machine snapshot
  you pick and confirm in Settings › System, which macOS cannot put back.
- **Scare you.** No health score, no alarm, no invented figure.
- **Watch you.** No account, no telemetry, nothing in the background. CoreTend asks this site
  whether an update exists (you can turn it off), and reads your apps' own update feeds only when
  you click Check for updates in Apps.

## Install

- **Download** `CoreTend-2.3.0-universal.dmg` (notarized) from [Releases](https://github.com/ahmetbsbnr/coretend/releases/latest) or the [site](https://coretend.ahmetbsbnr.com).
- **Homebrew:** `brew install --cask ahmetbsbnr/coretend/coretend` (also links `coretend` in your PATH)
- **Terminal and AI assistants:** [`coretend` on npm](https://www.npmjs.com/package/coretend) — `npx coretend clean` · `npx -y coretend mcp`; see [docs/CLI.md](docs/CLI.md).

macOS 14 Sonoma or later, Apple silicon or Intel. English, French, German, Spanish, Italian and Japanese (follows macOS). CoreTend asks for Full
Disk Access once, to read Mail, Safari and app data; without it, it reads what macOS allows.

## Build from source

```sh
swift build --product CoreTendApp   # the app
swift build --product CoreTendCLI   # a read-only command-line tool
make check                          # tests, the safety audit and the site checks
make app                            # an unsigned CoreTend.app in Artifacts/
```

Swift 6, SwiftPM; one runtime dependency, [Sparkle](https://sparkle-project.org), for signed updates. The code is organised in modules: `DesignSystem` (the Serre
design and the living greenhouse), `ScanCore` (read-only scanning), `SafetyCore` (the only code that
may move a file — to the Trash), `Domain`, `Persistence`, `AppShell` and the app itself, plus
the widget (`CoreTendWidget`), the Finder menu (`CoreTendFinder`) and the optional system helper
(`CoreTendHelper`, `HelperProtocol`), which link no other package.

## Contributing

Read [CONTRIBUTING](.github/CONTRIBUTING.md) and [GOVERNANCE](.github/GOVERNANCE.md). Security issues:
[SECURITY](.github/SECURITY.md). Privacy: [docs/Privacy.md](docs/Privacy.md). Code under
[Apache 2.0](LICENSE), documentation under CC BY 4.0 ([docs/LICENSING.md](docs/LICENSING.md)).