Mac app

Install and set up Gab AI for Mac, learn Chat and Work, save files, use voice and shortcuts, and keep the app updated.

Gab AI on your Mac

Gab AI for Mac brings Chat, AI models, Bots, media tools, and Work into a native desktop app. Work can use project folders, browser tabs, and supported Mac apps that you choose. You can review file changes, restore supported edits, run local checks, and continue folder tasks from a paired phone. Sign in with your existing Gab AI account to use the same conversations, plan, and credit balance. Folder permissions, command settings, and recovery originals belong to the Mac where you set them up.

Before you begin

Install and sign in

  1. Download from Gab AI — Open the Mac download page below for the installer and setup instructions. Choose Download for Mac when an installer is listed.
  2. Put the app in Applications — Open the downloaded archive. For a ZIP, double-click it in Finder to extract Gab AI.app, then drag the app into Applications. If your download is a disk image, open it and drag Gab AI into Applications. Open the installed copy from Applications.
  3. Use the same sign-in method — Choose Sign in if you already have an account, or create an account. Use your existing email/password, Google, or Apple sign-in. Complete any browser sign-in and return to Gab AI. Using the same account keeps your chats, subscription, and credits together. Use Forgot password? for an email/password account.
  4. Check your account and settings — Open Gab AI → Settings… or press Command–Comma. Confirm that the expected chats and credits are available. Appearance controls your theme; General and Personalization hold conversation preferences. Mac app contains browser/app access, folder access, and recovery history. Remote access is a separate settings section.

Downloads and account guides

Start with Chat

Choose New Chat from the File menu, select a model in the composer, and send a question. Attach a reference with Upload File or drag a file from Finder. Continue in the same conversation when you want the model to use its earlier context. Search finds saved conversations; collections group related chats and uploads. Use Bots for assistants with reusable instructions. Image, video, and music tools create media using your account’s credits. The model or tool you select determines which inputs and outputs are supported.

Complete your first local Work task

  1. Prepare a small project — In Finder, create a folder with a few notes or sample documents. Choose Work in the composer or Work → New Work in the menu bar.
  2. Connect the folder before sending — Open Project folder, choose Choose another folder…, and select your folder. Check Read-only access (inspect files without changing them) for a review-only task. Leave it unchecked to allow edits, then choose Use Project Folder. Confirm the folder name in the composer.
  3. Describe a finished result — Name the input files, the output you want, and where to save it. Use the example below with read and write access. Uploads provide individual references; a project folder lets Work read and save files in that directory.
  4. Follow the task — Read progress and respond to questions or approval requests. Send a follow-up to refine the result. The Work menu offers Send or Queue Message, Send Now, and Stop Run. Stop Run ends the active run; development servers have their own Stop server control.
  5. Open and review the result — Open the delivered file in the conversation. Ask for revisions in the same chat. For local edits, open the folder menu → Review changes. Task history shows supported edits and recovery actions; Git repositories also offer repository diffs.
Read the notes in this project folder. Create project-brief.md here with a summary, open questions, and a checklist of next steps. Use only the supplied notes and mark anything missing. Tell me which files you read and changed.

What you can do next

Set up browser and app access

Open Settings → Mac app → Browser and app access → Set up browser and app access. Connect Brave or Chrome tabs with the extension, or select Safari and supported Mac apps and follow the permission prompts. The browser guide below walks through connection, website approval, Take over, and Hand back.

Install the browser extension preview

The manual preview provides side chat in Brave or Chrome with your Gab AI sign-in. Connecting it to a compatible Mac app also enables browser automation. Open the extension page below for the download and illustrated installation steps, including Load unpacked, profile selection, and manual updates.

Detailed Mac guides

Open, edit, and save files

Open a delivered file from the conversation or your Files library. Use the file’s own controls to preview, edit, play, download, or export it. Document, spreadsheet, and presentation exports are covered in the workshops below. Available controls depend on the file type and your app version. When a native Save dialog opens, choose the destination and filename, then Save. Exporting a chat artifact creates a copy at that location. For a task that should update a connected project, explicitly name the project-relative output path in your instructions and check Review changes afterward. An attachment or preview alone does not give Work access to the surrounding Finder folder.

Artifact workshops

Dictation and voice

Use the microphone control to dictate a Chat message or a Work instruction. Allow microphone access when macOS requests it, speak, stop recording, and review the transcribed draft before sending. Dictation can also supply a follow-up while Work runs. Live voice conversation requires Plus and is available in Chat when its voice controls are shown; Work uses dictation rather than live voice mode. End the voice session when finished. If recording is unavailable, check Gab AI under System Settings → Privacy & Security → Microphone. Audio and transcripts are processed by Gab AI’s services; this is not offline dictation. If voice gets stuck starting, bring Gab AI to the foreground and click the voice button again after checking microphone permission. An older build may still show Use Voice Mode in your browser; check for an updated Mac release or use web voice until one is available.

Useful Mac shortcuts

Keep the app available and up to date

Closing the main window hides it while Gab AI stays running. Reopen it from the Dock or Window → Show Main Window. Quitting with Command–Q ends the app’s connection to local files, browser/app access, and managed commands. Keep the Mac awake, online, and Gab AI running whenever a task or paired phone needs those resources. In a direct-download release with updates enabled, choose Gab AI → Check for Updates…. When the sidebar shows Update, selecting it installs the update and restarts the app. Finish local work and save open edits before updating; the restart interrupts local connections and stops managed development servers. The browser extension preview is updated separately using the browser guide. If a documented control is missing, check for an app update and any availability message in the app. Some features require both a compatible Mac build and enabled service support.

Files, permissions, and cloud processing

Gab AI uses cloud AI models and a cloud Work agent. Files read from a project folder and browser/app text or images used for a task are sent to Gab AI and its providers. The app does not run an offline AI model. Folder access, tests/builds, development servers, browser/app access, website approvals, microphone permission, and Remote sharing are separate controls. Enable the capabilities your task needs. Recovery originals remain on the Mac where the edits were made; signing in on another device does not move those originals there.

If something goes wrong

Chats or credits are missing: confirm that you used the same account and sign-in method as on the web. Complete any browser authentication before returning to the app. Project folder is missing: sign in, select Work, and start a new chat. A cloud-only chat does not gain a local folder when you select one for another task. Local files are unavailable: wake the Mac, open Gab AI, restore the network connection, and check Folder access. Reconnect a missing disk before retrying. An update cannot start: retry Check for Updates… with the Mac online. Use the official Mac download page if you need the installer. For browser permissions, failed commands, or recovery conflicts, follow the focused guides above.

Continue learning