> ## Documentation Index
> Fetch the complete documentation index at: /help/llms.txt
> Use this file to discover all available pages before exploring further.

# The Mac app: sign-in, tabs, menu bar and updates

> How Heym for Mac differs from the web app: signing in with a code, working in tabs, the menu bar icon, launching at login, updates and heym:// links.

The Mac app is the same Heym you use in the browser, in its own window. Your tasks, goals, habits and notes are the same everywhere, and every feature works the same way. On top of that, the Mac app adds tabs, a menu bar icon, a few shortcuts and automatic updates. This page covers only what's different on the Mac.

![Heym for Mac open on Today, with the window buttons and a Today tab at the top, the sidebar on the left and the day's tasks split into Overdue, All day, Morning, Afternoon and Evening](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/mac/mac-window.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=28579f567d410b622ab484278ed03fc6)

To download the app, see [Heym on your devices](/help/devices.md).

## Sign in

The first time you open the app, it shows **Sign in to Heym**.

* **Continue with Google** or **Continue with Apple** opens your browser. Sign in there. When the browser shows **Opening Heym…**, it hands you back to the app. If the app doesn't come to the front, click **Open Heym**. You can then close the browser tab.
* To sign in with email, type your email address and click **Continue with Email**. Heym emails you a one-time code. Type the 6-digit code into the app and click **Sign in**. The link in the same email works too. If no email arrives, click **Resend code** (it's available again after 60 seconds), or click **Back** to fix the address.

Once you're signed in, the app stays signed in. To log out, click your name at the top of the sidebar and choose **Log out**. The app then forgets your open tabs and shows the sign-in window again.

## Work in tabs

Tabs let you keep several pages open at once, like Today next to a goal you're working on. They sit in the strip at the top of the window. Each tab keeps its own back and forward history.

![The top of the Heym window on a Mac with back and forward arrows, three tabs named Today, Goals and Habits, and a plus button](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/mac/tabs.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=7b676a12484a978d41908e4647950de0)

Three tabs: Today, Goals and Habits

* **Open a tab:** click **+** at the end of the strip or press **⌘T**. A new tab opens on your start page, or on Today if your start page is **Last visited**. To choose that page, see [Customize Heym](/help/customize.md#choose-the-page-heym-opens-first).
* **Open a link in a new tab:** hold **⌘** and click it. The tab opens in the background.
* **Switch tabs:** click one, or use the shortcuts below.
* **Move a tab:** drag it left or right.
* **Close a tab:** point at it and click **×**, click it with the middle mouse button, or press **⌘W**. When only one tab is left, **⌘W** closes the window.
* **Go back or forward:** click the arrows left of the tabs. If your Mac's trackpad gesture for swiping between pages is on, swiping left or right works too.

The app remembers your tabs, so they're still there the next time you open it.

| Shortcut | What it does |
| - | - |
| **⌘T** | New tab |
| **⌘W** | Close the tab |
| **⇧⌘T** | Reopen the tab you closed last, with its history. Press again to go further back |
| **⌘1** to **⌘8** | Go to tab 1 to 8 |
| **⌘9** | Go to the last tab |
| **⇧⌘\[** or **⇧⌘]** | Go to the previous or next tab |
| **⌥⌘←** or **⌥⌘→** | Go to the previous or next tab |

Every other shortcut is on [Keyboard shortcuts](/help/keyboard-shortcuts.md).

## Add a task with ⌘N

Press **⌘N**, or choose **File** → **New Task**, to open the new task window from any page. It works while Heym is the app in front. There's no shortcut that adds a task while you're in another app.

## The menu bar icon and Launch at Login

Heym puts an icon in the menu bar at the top of your screen. Click it for three choices:

| Item | What it does |
| - | - |
| **Open Heym** | Opens the Heym window, for example after you've closed it |
| **Launch at Login** | When checked, Heym opens by itself when you log in to your Mac |
| **Quit Heym** | Quits the app |

Closing the window with the red button or **⇧⌘W** doesn't quit Heym. It keeps running in the Dock and the menu bar, but reminders don't appear until you open a window again. See [How reminders reach you](/help/reminders.md#how-reminders-reach-you).

The Dock icon shows the number of open tasks due today, the same count you see next to **Today** in the sidebar. Overdue tasks aren't counted. Turning off **Show task count** in **Settings** → **Sidebar** doesn't remove the number from the Dock.

## Updates

Heym looks for updates when it starts, every hour while it runs, when you come back to it and when your Mac wakes from sleep. It downloads new versions by itself.

1. While an update downloads, **Downloading update…** shows at the bottom of the sidebar.
2. When it's ready, that spot shows **Relaunch to update** with the new version number. Click it to restart Heym on the new version now.
3. If you don't click it, the update installs the next time you quit Heym.

![The bottom of the Heym sidebar on a Mac with a Relaunch to update button showing a version number, just above Trash](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/mac/update-ready.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=504d47379de0a435006bc31f0490c926)

An update is ready to install

To check by hand, choose **Heym** → **Check for Updates…** in the menu bar. Heym tells you **You’re up to date**, that it's downloading a new version, or that a version is ready to install, with **Relaunch Now** and **Later**.

If the sidebar shows **Update failed**, click **Download it manually**. Your browser opens the page with the latest version. Install it the same way as the first time (see [Heym on your devices](/help/devices.md)).

## When Heym shows "You're offline"

If the app can't reach Heym's servers when it opens its window, it shows **You're offline**. Check your internet connection, then click **Try again**.

## Open Heym from a heym:// link

Links that start with `heym://` open the Mac app on that page. For example, `heym://today` opens Today, `heym://inbox` opens Inbox and `heym://goals` opens your goals. Use one in any app on your Mac that opens links to jump straight to that page in Heym. Heym's own notes only turn web addresses (starting with `http` or `https`) into links, so a `heym://` link in a note can't be clicked.

If Heym isn't running, the link starts it. If you're logged out, Heym asks you to sign in first.

## Good to know

* **Zoom and window size:** use the **View** menu to zoom in or out. Heym remembers the zoom level and where you left the window.
* **Copy and paste:** the **Edit** menu has the usual commands. Outside a text box, **⌘Z** works like the **Undo** button in the message Heym shows after an action, such as completing a task. See [Undo and Trash](/help/undo-and-trash.md).
* **Links to other sites** (for example billing pages or files you've attached) open in your browser, not in the Heym window.
* **Right-click menus:** right-click a misspelled word for spelling suggestions and **Add to Dictionary**, a link for **Open Link in Browser** and **Copy Link**, or a text box for undo, redo, cut, copy and paste.

## Related

> [card] [Your devices](/help/devices.md)
>
> Download the Mac app and see what each platform can do.

> [card] [Keyboard shortcuts](/help/keyboard-shortcuts.md)
>
> Every shortcut, including the Mac app's.

> [card] [Customize Heym](/help/customize.md)
>
> Choose your start page, sidebar and theme.

> [card] [Can't sign in](/help/sign-in.md)
>
> What to try when a code or link doesn't work.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.