Tethered

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="SocialPreviewDark.png">
  <source media="(prefers-color-scheme: light)" srcset="SocialPreview.png">
  <img alt="Tethered" src="SocialPreview.png">
</picture>

# Tethered

Tethered is a macOS app for managing your Mac's battery, power modes, and sleep behavior. It brings charging controls, power settings, and battery history into one place, with quick access from the menu bar.

<a href="https://github.com/Tumerit/homebrew-tap"><img src="https://brew.sh/assets/img/homebrew.svg" alt="Homebrew logo" width="24" height="24"> Install with Homebrew</a>

```sh
brew install --cask Tumerit/tap/tethered
```

<a href="https://github.com/Tumerit/Tethered/releases/download/v1.0.0/Tethered.alfredworkflow"><img src="Assets/alfred-icon.png" alt="Alfred icon" width="24" height="24"> Alfred Workflow</a> — Currently testing. Requires Alfred 5 with Powerpack and Tethered installed and running.

## What you can do

<table>
  <tr>
    <td width="60%"><img src="Screenshots/menu-bar.png" alt="Tethered menu bar panel with charging limit, power mode, and low battery controls" width="100%"></td>
    <td valign="top">
      <ul>
        <li><strong>Manage charging:</strong> Set a charging limit, use Sailing to let the battery discharge before charging resumes, and pause charging when the battery gets too warm.</li>
        <li><strong>Control power and sleep:</strong> Choose High or Low Power behavior, configure wake and sleep settings, and use Caffeinate when you need your Mac to stay awake.</li>
        <li><strong>Automate routines:</strong> Apply power mode and Caffeinate actions when selected apps launch, activate, deactivate, or quit. Use keyboard shortcuts and Apple Shortcuts for frequent actions.</li>
        <li><strong>Save your setup:</strong> Create profiles for different settings and configure battery calibration schedules.</li>
        <li><strong>Calibrate your battery:</strong> Start a calibration cycle when you choose, or let Tethered schedule one according to your calibration policy.</li>
        <li><strong>See battery history:</strong> Check battery health and cycle count, and explore charge level and temperature over time.</li>
        <li><strong>Make it yours:</strong> Adjust display brightness behavior across power modes, customize battery alerts, and manually or automatically dismiss the persistent macOS low battery banner.</li>
      </ul>
    </td>
  </tr>
</table>

## Pro Access

Pro Access is **$9.99 per device**. Pay once, lifetime upgrades. It unlocks extended charging controls and heat protection options, power mode thresholds and system controls, app-based automation, Caffeinate presets, additional keyboard shortcuts and Apple Shortcuts actions, iCloud settings sync, and more alert customization. You can purchase or check access for this Mac in Tethered's Pro Access settings.

## Your data

Tethered keeps your settings and battery history locally on your Mac. With Pro Access, you can enable iCloud sync for your settings and assets, or back up and restore them through your iCloud account. Battery history remains available locally in Tethered's Application Support folder.

You can manage settings in the app, view battery health and charge history in **Stats**, and export battery health history as **CSV or JSON**. Tethered also lets you export its logs. Open **Account → iCloud** to find the local data location and iCloud backup controls.

## AI Integrations Preview
**Requires Tethered 1.2.0+ installed and running on the same Mac and user account, Pro access, Task Sessions enabled, and a saved task profile.** 

Connect a local AI assistant to Tethered while it runs builds, test suites, data-processing jobs, etc. A saved task profile can:
- Request Automatic, Low Power, or High Power mode where supported
- Keep your Mac awake with Caffeinate
- Deprioritize or temporarily suspend eligible background apps.
  
Process controls can apply throughout a session or activate at warning or critical memory pressure, with app exceptions, frontmost-app protection, and configurable memory thresholds. Ending or expiring a session releases temporary controls and resumes apps Tethered suspended. You configure the profiles in Tethered and can end sessions there at any time. The integration uses the app’s bundled local MCP adapter.

For Claude Desktop, download [tethered-0.2.6.mcpb](https://github.com/Tumerit/Tethered/releases/download/v1.2.0/tethered-0.2.6.mcpb). The MCPB launches the adapter from the installed app; it does not install Tethered. 

For Codex, Claude Code, Cursor, Gemini CLI, VS Code/Copilot, and other supported local clients, see [plugin installation and manual setup](Integrations/README.md).

Current State: [Integrations/VALIDATION.md](Integrations/VALIDATION.md)

## Screenshots

| Battery and charging | Battery history |
| --- | --- |
| ![Tethered battery charging and heat protection settings](Screenshots/battery.png) | ![Tethered battery statistics and charge history](Screenshots/stats.png) |

| Power controls | App automation |
| --- | --- |
| ![Tethered power mode and wake controls](Screenshots/controls.png) | ![Tethered per-app power mode and Caffeinate actions](Screenshots/apps.png) |

| Display settings | Alerts and appearance |
| --- | --- |
| ![Tethered display brightness settings](Screenshots/display.png) | ![Tethered battery alert appearance settings](Screenshots/appearance.png) |

## Get Tethered

Download the macOS installer from [GitHub Releases](https://github.com/Tumerit/Tethered/releases). The `.pkg` file is for manual installation; the `.Sparkle.zip` file is used by the app's built-in updater.