A little setup.
A calmer day.

Before you start

You need an Apple silicon Mac (M1 or later) running macOS 14 or later. In Apple menu → About This Mac, check the chip and macOS version. Intel Macs are not supported by this release.

For readable limits, check your installed provider version and subscription sign-in against the compatibility table. Claude Desktop alone does not connect the Claude Code reader. Other versions may be detected without readable limits.

Make Quotchi at home

1. Download from Quotchi. Use the download button here or on the home page. The main download is a disk image (DMG).
2. Open the disk image. In Downloads, double-click the Quotchi DMG to open the installation window.
3. Move it to Applications. Drag Quotchi onto the Applications folder in that window. Eject the Quotchi disk, then open the app from Applications.
4. Confirm the first launch. macOS may ask whether you want to open an app downloaded from the internet. For the copy you downloaded here, confirm Open. If macOS says the developer cannot be verified, the app is damaged, or it cannot check the app, stop and contact support.
5. Meet your companion. Follow the three welcome screens: meet Quotchi, choose the tools to watch, and find the sloth in your menu bar. You can continue while a tool still needs setup.

No Terminal command or installer package is needed to install Quotchi. Your provider’s own CLI setup remains separate.

Find your first reading

1. Sign in through your supported Claude Code or Codex client using the subscription account you already use. Quotchi does not ask for pasted credentials.
2. Click the sloth in your menu bar. In Settings → AI tools, review the connection message and choose which tools to watch.
3. Choose Refresh and look for a current reading in Now. Percentages show the amount used; each readable window has its own limit and reset.

A dash means a reading is unavailable. “Partial” means some limits may be missing. If no limits appear, use the connection recovery steps. Manual refresh has a one-minute cooldown.

Make it yours, at your pace

• Alerts: enable alerts in Quotchi Settings and respond to the macOS notification prompt if you want notifications. You can review notification access in System Settings → Notifications.
• Login startup: choose the launch-at-login option in General settings if you want Quotchi available after signing in to your Mac.
• Widgets: enable widget sharing in General settings, then add Quotchi from macOS Edit Widgets.
• Stats: open Stats and opt in to reading available local token/model summaries. Saved observations and Pro history have separate collection controls. See the privacy guide.
• Gemini: the optional experimental pane reader needs explicit Accessibility permission and one open English Usage limits pane. Claude and Codex quota readers do not require enabling that pane reader.

For Pro, import the signed file delivered with your purchase in Settings → Pro → Import license. Keep the original file for reinstalling or your second Mac. See activation and restoration.

Install an update

This release uses manual updates. Automatic download and installation are not included, and the signed check-for-updates feed is not configured yet. Settings → Updates shows the installed version and build. See what’s new before updating.

1. Download the latest available release from this website.
2. Quit Quotchi from its menu before replacing the app.
3. Open the new DMG and drag Quotchi into Applications. Choose Replace when Finder asks, then eject the disk.
4. Open Quotchi again and verify the version and your connections. Keep your original Pro license file available if you need to import it again.

Do not delete local data just to update. If you used a development or earlier test build, its separate app identity may require fresh setup in the production app.

Remove Quotchi

If you want to remove retained readings, use the history export/deletion controls and Settings → Privacy before uninstalling. Saved Stats observations have a separate deletion action; deleting these does not delete your provider’s records or exported share cards.

Turn off launch at login, quit Quotchi, and move Quotchi.app from Applications to the Trash. Removing the app alone does not erase retained local records or request a Pro refund. See the seven-day refund policy for refund requests.

Need a hand?

Read compatibility and troubleshooting, or email [email protected] with the app version, macOS version, provider version and visible connection message. Leave out credentials and prompts.