> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.usepassport.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.usepassport.ai/_mcp/server.

# Control Passport from the macOS menu bar

As a Passport Member on a Mac, you can use the Passport menu bar app to check Passport's status, copy secret references, and pause or restart Passport without entering commands. The app sits in the macOS menu bar and runs the Passport CLI for you.

## Prerequisites

Before you begin, make sure you have the following:

* A Mac with the Passport CLI installed. The installer also installs the menu bar app, **Passport**, in your Applications folder. For installation steps, see [Install the Passport CLI](/passport/reference/passport-cli/install/).
* A Passport account on your team.

## Open the menu bar app

The menu bar app opens by itself when Passport starts, such as after you run `passport setup` or when you sign in to your Mac. Look for the Passport icon at the right side of the macOS menu bar.

To open the app yourself, do the following:

1. Open Finder.
2. In the sidebar, select **Applications**.
3. Double-click **Passport**.

Opening the app turns Passport on. If the menu bar is full, macOS might not show the Passport icon. In that case, the app opens a window with a **Passport Menu** button that shows the same menu.

## Check Passport's status

The icon shows whether Passport is on. A solid icon means Passport is on, an icon with a pause symbol means it's paused, and a gray icon with a slash through it means it's off.

Click the icon to open the menu. The first rows show whether Passport is running, paused, or off, and whether setup is needed. It also shows who is signed in. When something needs your attention, the menu shows what to do next.

## Copy a secret reference

You can find and copy a secret reference without opening the Passport app in your browser.

To copy a secret reference, do the following:

1. Click the Passport icon, then select **Secret References**, or press **Command-K**.
2. Enter part of a name, endpoint, or ID to filter the list.
3. Use the arrow keys to select a reference, then press **Return**.

Passport copies the `{{vault:<id>}}` reference to your clipboard and closes the panel. Paste it into your request.

A secret reference works only for the endpoint it was issued for. If one secret is bound to several endpoints, the list shows one row for each endpoint. For more information about using a reference, see [Call an API with Passport](/passport/use/call-an-api-with-passport/).

The list shows the access you currently have. To get access to more APIs, see [Request API access](/passport/use/request-api-access/).

## Pause, resume, or restart Passport

Pause Passport when you need to step aside for a moment. While Passport is paused, the daemon stops routing new connections through the Passport Proxy, so they go straight to their destination. The `passport request` command still uses the Passport Proxy. Select **Resume** to turn Passport back on.

Select **Restart** if Passport isn't behaving as expected. If Passport is off, the same menu item starts it.

## Sign in or out

Select **Log In** to sign in to Passport. Passport opens your browser so you can finish signing in. Select **Log Out** to sign out.

## Quit the app

Select **Quit** to close the app. Quitting stops the local daemon, so requests from tools like curl and scripts no longer go through the Passport Proxy until you open the app again. The `passport request` command still uses the Passport Proxy, because it doesn't need the daemon. If your organization manages Passport with mobile device management (MDM), your administrator controls whether Passport stays on.

## Troubleshoot

The **Troubleshoot** menu helps you gather information when something goes wrong:

* **Export Debug Bundle** — Saves logs and diagnostic information that you can send to your administrator or support.
* **Show Logs in Finder** — Opens the folder that contains the Passport logs.

## Change settings

The **Settings** menu has switches you can turn on or off:

* **Usage Telemetry** — Sends information about how you use the Passport CLI, such as which commands you run.
* **Crash Reporting** — Sends a report when the Passport CLI stops unexpectedly.

If your administrator has set either option, it's grayed out and you can't change it. You can also manage these options from the terminal. For details, see [Telemetry commands](/passport/reference/passport-cli/telemetry/).

## Keyboard shortcuts

The menu supports the following shortcuts while it's open:

| Action                    | Shortcut  |
| ------------------------- | --------- |
| Copy a secret reference   | Command-K |
| Pause or resume Passport  | Command-P |
| Restart or start Passport | Command-R |
| Sign in                   | Command-L |
| Quit                      | Command-Q |