> ## Documentation Index > Fetch the complete documentation index at: https://squad.so/docs/llms.txt > Use this file to discover all available pages before exploring further. # Squad for Mac (private beta) > The Squad app for your Mac: the menu bar, Needs you, Delegate from any app, talking to your squad, the notch, notifications, and Mac access. Squad for Mac is in private beta. It is not available to download yet. This page describes how the app works in the beta, so that you know what to expect. Details can change before the app is public. Squad for Mac is a native app for your squad. It signs in to the same workspace as the dashboard and shows the same live work. It adds ways to run your squad a few seconds at a time without opening a browser: a menu bar item, one queue for everything that needs you, a panel to hand out work from any app, voice, and the notch on your Mac's screen. The app uses some words of its own. It calls your agents teammates, a mission a task, a scheduled task a routine, and a ticket a question. You need a Mac with Apple silicon and macOS 14 or later. ## The main window The sidebar lists **Today**, **Email**, and **Docs**, then your agents under **Your squad**. The other screens open from the place where they belong, most of them from **Today**. At the top of such a screen, a link names the place that you came from and takes you back there. The **Go** menu lists the sidebar screens, each with a shortcut, and then the screens that open on demand. | Screen | Shortcut | What it shows | | - | - | - | | **Today** | ⌘1 | A greeting and one sentence about who is working, what needs you, and what your squad finished today. Below it, only when they hold something: what needs you, tasks assigned to you, what each agent did today, and today's routines. See [Today](#today). | | **Email** | ⌘2 | Your agents' inboxes. See [Give an agent an email inbox](/docs/email). | | **Docs** | ⌘3 | Your squad's docs. See [Squad docs](/docs/squad-docs). | | An agent's page | | Select an agent under **Your squad** to open it. The header has **Chat** and **About**, a settings button to set up the agent, and a menu. See [Chat with your agents](/docs/chat). | | **Needs you** | | Everything that needs you, in one queue. The link under **Needs you** on **Today** opens it. See [Needs you](#needs-you). | | **Tasks** | | Your tasks, on a board with the columns **Not started**, **Needs you**, **Working on it**, and **Done**. **See all tasks** on **Today** opens it. The web dashboard names the columns differently. See [Missions](/docs/missions). | | **Activity** | | What your squad did. **See all activity** on **Today** opens it. | | **History** | | Each run. **History** in the menu bar's menu opens it, and so does **See what happened** on **Today** when a job did not finish. A run that a restart cut short and that Squad picked back up says so. When a day has more runs than **History** lists, a notice says that its earliest runs are not shown. See [See what your agents did](/docs/runs-and-health). | | **Routines** | | Your routines. **See all routines** on **Today** opens it. On **Routines** > **Week**, the **Runs continuously** row shows the first routines, then a link with the number and **more** that switches to **List**. See [Scheduled tasks](/docs/scheduled). | | **Computer** | | The workspace computer. Open it from the **Go** menu, the command palette, or the computer card in a chat. Only the workspace owner and Administrators can watch it, while the workspace computer is on. See [Watch or take over an agent's computer](/docs/computer). | | **Skills** | | Your squad's skills. **Skills** on an agent's **About** opens it too. See [Skills](/docs/skills). | | **What your squad knows** | | What your squad knows. For the owner and Administrators. See [Memory](/docs/memory). | Other shortcuts: * **Attach** (⌘⇧A) attaches a file to your message. * **Search Squad…** (⌘K) opens the command palette. * **Next New Reply** (⌥⌘↓) opens the next conversation with a reply that you have not read. * **Back** (⌘\[) and **Forward** (⌘]) in the **Go** menu move between the screens and items that you opened, as in Safari. ⌘← and ⌘→ do the same while you are not typing in a box. A trackpad swipe, with the fingers that your Mac's "Swipe between pages" setting uses, and a mouse's back and forward buttons do the same too. * **New task** (⌘⇧N) on **Tasks**, in the board view. A Viewer does not have it. * **New email** (⌘⇧N) on **Email**, for the owner or an Administrator, when the squad has an inbox. * **Delegate…** (⌘N) opens the Delegate panel. A Viewer does not have it. See [Delegate from any app](#delegate-from-any-app). * **Open Squad** brings the main window to the front. ⌘1 to ⌘3 also bring it forward, on a screen. * On **Email**, J and K move to the next or the previous email. * On **History**, D, W, M, and S switch to **Day**, **Week**, **Month**, and **Schedule**. The left and right arrows move to an older or a newer period, except in **Month**. T comes back to today. Esc closes the run that you opened. In **Week**, a day with more runs than its column holds shows a link with the number and **more**, which opens that day. * The letter shortcuts on **Email**, **History**, and **Needs you** do not act while you type in a box. The letters go into the box. * **Bigger** (⌘+) and **Smaller** (⌘−) in the **View** menu change the text size. **Actual Size** (⌘0) resets it. Squad remembers the size between launches. The **Help** menu has **Squad Help**, **What's New in Squad**, **What Your Squad Can Do**, **What the Mac Adds** (a tour of the Mac app), **Squad Docs**, and **Email Support**. ### The sidebar * The **+** button beside **Your squad** asks your lead to hire a teammate. A Viewer does not see it. * Your group chats and your pins show below your agents. * **Today** shows the number of things that need you. **Email** shows the number of unread emails, and **Docs** the number of new and updated docs. * When an update is available, a card says so, with **Update**. When it is downloaded, the card says that Squad is ready and shows **Restart to update**. See [Updates](#updates). ### Today * Under **Needs you**, **Today** shows what only you can fix, then the first few questions. When more wait, the link under them opens **Needs you**. See [Needs you](#needs-you) and [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). * For the owner and Administrators, work that did not finish today shows under **Needs you**, with one sentence that says what did not finish. When a connection expired, the button is **Reconnect** followed by the app's name. Otherwise, **See what happened** opens that agent's runs in **History**. Selecting the X sets that item aside. A later failure shows as a new item. * **Ideas for your squad** suggests work for your squad. It shows in a new squad's first days, or when nothing waits for you and nobody is working. Select **See all ideas** for the full list. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). * At the end of **Today**, **Share your squad's day** opens the share card. See [Share your squad's day](#share-your-squads-day). ### The Dock icon The Dock icon shows a badge with the number of things that need you, in every squad that you are in. With **Replies and mentions** on in your Mac notifications, it also counts the conversations with replies that you have not seen. With nothing to count, there is no badge. ## Keyboard navigation Tab reaches every control in the app, whatever your Mac's Keyboard navigation setting is. The order follows the screen: first the sidebar, then the screen, column by column. In a list, Tab moves through every row in reading order, also in a list beside another column, such as the conversations beside a chat. Tab also reaches the buttons on chat cards. Space and Return press the control in focus. Shift-Tab moves back. ## Docs To clear the new and updated marks on docs without opening each one, right-click **Docs** in the sidebar and choose **Mark all docs as read**, or select **Mark all as read** in the Docs header. A doc's menu also has **Mark as read**. The marks are kept on this Mac. To narrow the list, open **Filter** beside the search. Under **Show**, pick **Every kind** or one kind of doc. This part shows when your squad has more than one kind. Under **Order**, pick **Recently edited**, **Name (A to Z)**, or **Longest**. After you pick a kind, the button shows that kind's name. ## Email While the full text of an email loads, the email shows "Loading the message…". When it does not load, the email says so, with the reason. A draft's buttons show only after its text has loaded. An email counts as read only once its text shows. ## Text in messages You can select text across a whole message. A bar over the selection offers: * **Quote in reply**: puts the passage, quoted, at the top of your draft. * **Ask about this**, on an agent's reply: sends "Tell me more about this:" with the passage in the same conversation. In a group chat, it goes to the group. When the app cannot send it as a plain reply, for example to a paused agent, it puts the question in your draft instead. * **Copy**: copies the selection. ⌘C and **Copy** in the right-click menu also copy the selected words, exactly as they read. So does dragging them out of the message. Code blocks show in a panel, and quotes show with a bar beside them, in your messages and in your agents' replies. To delete a file that you sent, select the trash button beside it, or right-click the file and choose **Delete File…**, then confirm. It works as on the web. See [Delete a file that you sent](/docs/chat#delete-a-file-that-you-sent). ## The side panel in chat Beside a conversation with an agent, the side panel lists what that conversation made: files, docs, lists, emails, and tasks, newest first. Select an item to open it. A file opens in Quick Look. Right-click a file for **Preview**, **Open**, and **Copy Link**. The panel opens by itself once the conversation has made something, and stays beside that agent's conversations after that. Its button, beside **Chat** and **About** at the top of the agent's page, shows or hides it. A narrow window keeps the panel closed. ## A name that an agent suggests When an agent suggests a name for a conversation, a note beside the title says so. Click the title to rename the conversation. Select **Use** followed by the suggested name, then **Save**, to take it. Select **Not this one** to turn it down, and it is not offered again. You see the suggestion only where you can rename the conversation. See [Work with threads](/docs/chat#work-with-threads). ## The menu bar The Squad mark sits in the menu bar, with the number of things that need you: open asks, email drafts and escalations, what only you can fix, suggested triggers, and, except for a Viewer, tasks that wait on you with no question asked yet. Click it to see who is working, what needs you, and to answer quick asks. It shows the first few asks. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). When something to fix or a suggested trigger waits, a link under the asks opens it in **Needs you**. When nothing waits, it says "Nothing needs you." Its **⋯** menu has **Delegate…** (not for a Viewer), **Share your squad's day…**, **History**, **Snooze the notch**, **Settings…**, and **Quit Squad**. ## Needs you **Needs you** puts everything that waits for you in one list. First comes what only you can fix, and the triggers that your agents suggest. Then come every open ask, every email draft that waits for your review, and every email escalation, most urgent first. **Today** shows the first few asks, and the link under them opens the whole list. A long list shows its first rows, and a link under them, such as **Show 12 more**, shows the rest. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). Tasks that wait on you with no question asked yet show at the end of the list, under **Waiting on you, nothing asked yet**. Select **Ask what it needs**, or **Ask them all**, and the agent sends you its questions. A Viewer does not see this section. What only you can fix, and the suggestions, show as cards with the fix as the main button: * A low or full disk on the workspace computer, for everyone except a Viewer. Select **Ask** followed by your lead's name and **to free up space**. It opens a new conversation with your lead, with the request written but not sent. You can set a low disk aside with the X. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). A full disk stays until there is room. See [Your cloud computer's disk is low or full](/docs/agent-stuck#your-cloud-computers-disk-is-low-or-full). * Work that did not finish today, for the owner and Administrators, with **Reconnect** and the app's name when a connection expired, or **See what happened**. The X sets it aside. See [Today](#today). * Routines that never run as they are set up, for the owner and Administrators. **Fix it** opens **Routines**. The card stays until the routines are fixed. * A trigger that an agent suggests, for the owner and Administrators. Select **Turn it on**, or **Look first** to open the trigger's page. See [Approve a trigger that an agent suggests](/docs/triggers#approve-a-trigger-that-an-agent-suggests). These count in the number on **Today**, the menu bar, the Dock, and the notch. You can work through the asks with the keyboard: | Key | Action | | - | - | | J and K, or ↓ and ↑ | Move to the next or the previous ask. | | A | Approve an approval or a yes-or-no question. | | 1 to 9 | Pick an option. On a yes-or-no question, 1 is yes and 2 is no. | | ⌘↩ | Do the main action of the ask. | | U | Undo your last answer. | While you type in a box, for example an answer, these letters and numbers go into the box instead. An answer shows as done only after Squad confirms it. Undo reopens the ask. See [Answer tickets](/docs/tickets). To sort through a long list: * When some asks have waited for more than a day, filters show: **All**, **Over a day**, and, when there are any, **Over 30 days**. Each shows its count. * **Show resolved** shows the asks that are already answered. **Hide resolved** hides them again. * With a filter on, the owner or an Administrator can select **Archive** and the count to archive those questions. Their tasks leave the board too. * In the **⋯** menu, the owner or an Administrator can select **Clear all** and the count of open questions. This clears them without an answer, and you choose whether their tasks are archived too. * Under **Waiting on you, nothing asked yet**, **Clear all** archives those tasks after you confirm. Email items are for the owner or an Administrator: * A draft has **Send now**, **Revise with** followed by the agent's name, and **Discard**. * An escalation has **Tell** followed by the agent's name and **what to do**, and **Dismiss**. A Collaborator sees **Tell** followed by the agent's name and **what to do**, with a note that the owner or an Administrator handles the email. ## Delegate from any app Press ⌥Space in any app to open the Delegate panel on top of it. The panel opens on your lead. Type the job, pick the agent if you want another one, and send it with ⌘↩ or the send button. It starts a new conversation with that agent. Focus then goes back to the app that you were in. A Viewer cannot open the panel. * When you open the panel from Safari or a Chromium browser such as Chrome, the page that you have open goes with the message. The first time, macOS asks you to allow Squad to control the browser. To send without it, select the X on the page chip (**Leave the page out**). * When Squad can see your screen, a picture of the window that you were in goes with the message, so the agent can see what you see. To send without it, select the X on the screen chip (**Leave your screen out**). Until Squad can see your screen, a screen button beside the send button, **Let Squad see your screen**, asks macOS for that permission. You can also select text or a link in any app and choose **Send to Squad** in the app's **Services** menu. The Delegate panel opens with the text in it. ## Talk to your squad Hold ⌃⌥Space and speak, then let go to send. Start with an agent's name to send the message to that agent. Without a name, it goes to the agent whose chat is open, or else to your lead. A quick tap keeps listening until you tap again. The first time, macOS asks for access to the microphone and to speech recognition. With **Hear the answer** on, the reply is read aloud when it arrives soon after your question. A later reply is not read aloud, and waits for you to select Play. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). With **Squad in the notch** on, it waits in the notch. Talking again stops the reading. ## Siri, Shortcuts, and Spotlight Squad adds these actions to Siri and the Shortcuts app: **Delegate to Squad**, **What Needs Me in Squad**, **Show What Needs You in Squad** (it opens **Needs you**), **New Squad Task**, and **Make My Squad's Recap Card**. Spotlight finds your agents, your tasks that are not done, and your docs. Squad clears them from Spotlight when you sign out or switch squads. ## Watch the workspace computer The owner and Administrators can watch the workspace computer while it is on. In a conversation with an agent, select **Watch** to keep that agent's browser in a small window above your other apps. On **Computer**, **Float while you work** does the same for the agent that you picked. When **Computer** opened from a conversation, **Back to the conversation** takes you back. See [The main window](#the-main-window). ## Squad in the notch When you are in more than one squad, the notch also counts what needs you in your other squads, up to a limit. It counts their new replies too, unless you turned off **Replies and mentions** in your Mac notifications. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). Its peek shows a few other squads with something for you. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). Select one to switch to that squad. The menu bar panel and the squad switcher show the same counts. With **Squad in the notch** on, your squad lives around the notch at the top of your screen. It opens when an agent needs you, so you can answer without leaving what you are doing. Questions and email items then skip the notification banner. * **Chat in the notch** (⌃⌥C) opens your squad's conversations under the notch. Clicking the notch does the same. Esc closes it. * The opened notch has **Open Squad**. When something waits, it also has **Answer** followed by the number, or **Open Needs You** when what waits includes something to fix or a suggested trigger. Right-click it for **Chat with Your Squad**, **Delegate…** (not for a Viewer), **Hide for Now**, and the snooze choices. Right-click the closed notch for **Hide for now**, **Open Needs You** when something waits, the snooze choices, and **Notch settings…**. * For the owner and Administrators, a working agent's row in the opened notch has **Stop** when you point to it. See [Stop a run from your Mac](#stop-a-run-from-your-mac). * **The notch shows** chooses what the notch shows at rest: **Activity**, **Only changes**, or **Only what needs you**. * To snooze the notch, choose **Snooze for 1 hour** or **Snooze until tomorrow**. Right-click the notch or its reply card, or use **Snooze the notch** in the menu bar's menu. **Stop snoozing** turns it back on. A snooze lasts after you quit the app. **Snooze until tomorrow** lasts until the next morning. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). * **Stay quiet in meetings**: while another app uses your microphone or camera, or your screen is shared, Squad does not speak or chime, and other news does not open the notch by itself. An answer to a question that you asked out loud still shows in the notch, with a Play button instead of being read aloud. ## Notifications on your Mac Squad shows a notification when something needs you, and, with **Replies and mentions** on, when someone answers you or mentions you. You can answer yes or no, pick an option, or reply from the notification itself. In **Settings** > **Notifications** > **On this Mac**, choose which notifications you get: * **Questions**: when an agent asks you something. * **Email that needs you**: when an agent's email needs your review or your answer. * **Replies and mentions**: when an agent or a person in your squad answers you or mentions you. It also covers the notifications when an agent finishes a routine and when a run does not finish. * **Friday recap**: a reminder on Friday to share your squad's week. For the time, see [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). * **Hold non-urgent decisions**: urgent and high-priority questions still come at once. The others arrive as one summary, at the time that you choose in **Deliver the summary at**. That setting shows while this one is on. For the times, see [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). These notifications are separate from the emails and alerts of your workspace. See [Choose your notifications](/docs/notifications). ## Settings for this Mac In **Settings**, **This Mac** is separate from your workspace settings. It has two pages, **General** and **Mac access**. **This Mac** > **General** has: | Setting | What it does | | - | - | | **Open Squad when you log in** | Keeps the menu bar, the notch, and notifications on without opening a window. | | **Confirm approvals with Touch ID** | Approvals, answers to questions, and email sends ask for Touch ID or your Mac's password first. | | **Animated teammates** | Shows each agent as a Squad character that shows what it is doing. Off keeps the faces still. | | **Updates** | A card with your version, **Check for Updates** or **Restart to update**, and the update switches. See [Updates](#updates). | | **Delegate from anywhere** | The shortcut for the Delegate panel. | | **Talk to your squad** | The shortcut for voice. | | **Chat in the notch** | The shortcut for the notch chat. | | **Hear the answer** | Reads replies aloud when you asked out loud and the reply arrives soon. See [Talk to your squad](#talk-to-your-squad). | | **Stay quiet in meetings** | Keeps Squad quiet while you are in a meeting or share your screen. | | **Squad in the notch** | Turns the notch on or off. | | **Play a sound when it opens** | Shows when **Squad in the notch** is on. Plays a sound when the notch opens. | | **The notch shows** | Shows when **Squad in the notch** is on. Chooses what the notch shows at rest. | | **Close notch cards with Esc from any app** | Shows when **Squad in the notch** is on. Lets Esc close a notch card while you work in another app. It needs the Accessibility permission for Squad in System Settings. | | **Share usage and crash reports** | Shares which parts of Squad get used, and the reports when the app crashes or stops responding. See [When the app crashes or stops responding](#when-the-app-crashes-or-stops-responding). | For **Mac access**, see [Mac access](#mac-access). Notifications for this Mac are under **Settings** > **Notifications** > **On this Mac**. See [Notifications on your Mac](#notifications-on-your-mac). ## Share your squad's day **Share your squad's day** makes an image of what your squad did today or this week, counted from its real runs, tasks, and docs. Open it from the end of **Today**, from the **⋯** menu in the menu bar, or from the command palette. * Choose **Today** or **This week**, and **Dark** or **Light**. * Turn on **Show my business name** to add it to the card. * Edit the **Caption**. * Select **Post on X**, **Share…**, **Copy image**, or **Save…**. ## Updates With **Check for updates automatically** on, the app checks in the background. With **Download updates automatically** on, it downloads updates, which install the next time Squad restarts. **Download updates automatically** works only while **Check for updates automatically** is on. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac) for how often the app checks. A card in the sidebar shows when an update is available or ready. Both switches are on the **Updates** card in **This Mac** > **General**. To check now, choose **Check for Updates…** in the **Squad** menu. When an update is ready, the menu item says **Restart to Update to** and the version. ## When the app crashes or stops responding When Squad for Mac crashes or stops responding, macOS gives the app a report the next time it opens. With **Share usage and crash reports** on, Squad sends that report to the Squad team after you sign in. With the switch off, Squad keeps no report and sends none, and turning it off stops a send that is under way. The switch is in **Settings** > **This Mac** > **General**. When the app stopped responding the last time it ran, a notice says so after you sign in. ## Stop a run from your Mac You can stop a running run from the app, as the owner or an Administrator. **Stop** is under the agent's working message in chat, on the run's row in **History** and in its details, and on a working agent's row in the notch when you point to it. Then select **Stop the run**, or **Keep going**. The same rules apply as on the web. See [Stop a run](/docs/runs-and-health#stop-a-run). ## Mac access With **Let your squad use this Mac** on, in **Settings** > **This Mac** > **Mac access**, your agents can ask for things on your Mac: a file in your Downloads folder, the page open in your browser, or a look at your screen. Nothing happens on your Mac until you say yes on the Mac, or until you share a folder for requests of that kind. ### Your Mac is not the workspace computer Your squad works on one [workspace computer](/docs/computer) in the cloud. Each agent has its own browser there. Your Mac is a different machine. Agents reach your Mac only through the Squad app, only while the app runs with **Let your squad use this Mac** on, and only with your approval for each request. ### What agents can ask for | Request | What happens on your Mac | What the agent gets | | - | - | - | | List a folder | The app lists the folder's files and folders. Hidden files are left out. | Names, sizes, and dates. | | Read a file | The app sends a copy of the file. | The text, in the reply, for a small text file. A saved copy in the agent's workspace for any other file. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). | | Write a text file | The app saves the text as a file. | A confirmation. | | Open a web page | The page opens in your default browser. Only web pages (http or https) open. | A confirmation. | | Read the open browser tab | The app reads the page open in your browser. It works with Safari and Chromium browsers such as Chrome, Arc, Brave, Edge, and Vivaldi. It does not work with Firefox. When no supported browser is in front, it reads the first supported browser that is open. | The page's title, its address, and the browser's name. | | See your screen | The app takes a screenshot of the front window of the app that you are using. When Squad itself is in front, it takes your whole screen without Squad's windows. The whole screen means your main display only. The window is chosen when the request arrives. The prompt names what it will share. | The screenshot, in the agent's workspace. | Each request carries a one-sentence reason from the agent, and the app shows you that reason. Agents are told to ask only when a task needs your Mac. ```text Ask your lead theme={null} Find the invoice from Acme in my Downloads folder on my Mac and attach it to the dispute. ``` ```text Ask an agent theme={null} Look at my screen and tell me what this error means. ``` The numbers for files, listings, and requests are on [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). ### You approve requests on your Mac When an agent asks for something that no shared folder covers, the Mac app shows the request at the top of your screen or as a notification. It names the agent, what it wants, the file, folder, or address, and the agent's reason. You choose one of these: * **Allow once**: the app does this one request. When the request would replace a file that exists, the prompt at the top of the screen shows **Replace it** instead. * **Always for this folder**: the app does the request and shares the folder. For a folder listing, that is the folder itself. For a file, it is the folder that holds the file. A read shares the folder as **Read only**, and a write shares it as **Read and save files**. Later requests inside the folder that its sharing allows run without asking. The prompt at the top of the screen names the folder, for example "Always for Downloads". When Squad cannot remember the folder, your yes still goes through for this one request, and the notch says that it was sent this once, without remembering the folder, and why. * **Deny**: nothing is shared. The agent is told that you did not approve. A request at the top of your screen that you do not answer moves to a notification after a short time. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). A request that you do not answer at all expires after a set time, and the agent is told that you did not answer. An agent that is denied or gets no answer is told to continue without it, and not to ask the same thing again in that run. Some requests always ask, even inside a shared folder: * **See your screen.** Squad never remembers screen access. Every screenshot asks you again. If Squad cannot see your screen yet, the prompt says so. Allowing the request then asks macOS for Screen Recording permission, and no screenshot is taken. The agent is told to ask again after you turn on Screen Recording for Squad. * **Replace a file that exists.** The prompt says "This replaces the file that's there." Existing files are only replaced when you approve that exact change. * **Open a web page** and **read the open browser tab.** Shared folders apply only to files and folders. ### Shared folders In the app's settings, the **Mac access** page lists your **Shared folders**. Each folder is **Read only** or **Read and save files**. A request to write a file needs a folder with **Read and save files**. * Share a folder ahead of time with **Share a folder**. It is a menu with **Read only** and **Read and save files**. Squad refuses to share the whole disk, **Volumes**, **Users**, or any folder that holds your home folder. * Stop sharing a folder with **Stop sharing** next to it. * Everything else stays on the default: every request waits for your yes. Shared folders belong to one Mac. Turning off **Let your squad use this Mac** removes the Mac from your workspace, together with its shared folders. Signing out of the app removes the Mac from every squad. The **Recent requests** list on the same page shows what agents asked for and what you decided, newest first, up to a limit. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). Each row has a chip: **Shared**, **Denied**, **Failed**, **No answer**, **Waiting for an answer**, or **In progress**. A request that waits for your answer on this Mac has **Allow** and **Deny** on its row, so you can answer it there too. ### What is never shared Your Mac refuses these requests, also inside a folder that you share. You are not asked about them. * Hidden files and folders. * Your Library folder. * Keychains. * System folders. * Anything outside your home folder, unless you share that folder. A file larger than the file size limit is not sent, also after you approve. Text larger than the write limit is refused before you are asked. When you approve a file read in the notch and the file is too large, the notch offers **Drop It in the Chat**. Approving from a notification or from a **Recent requests** row does not offer it. It opens the chat with that agent, with the file attached, so that you can add a note and send it. ### Who can use it Only your own work reaches your Mac. The Mac belongs to the workspace owner, and only the owner can connect a Mac and answer its requests. When an agent works for a teammate, Squad refuses its Mac requests. The agent tells the teammate that only the owner can ask for something on the owner's Mac. See [Invite teammates to your workspace](/docs/teammates). ### When your Mac is not connected Your Mac counts as connected while the Squad app is open on it, with **Let your squad use this Mac** on and your own squad open in the app. When it is not connected, agents usually do not have the Mac request tools, or a request says that your Mac is not connected. Either way, the agent tells you to open the Squad app on your Mac, and continues without it. ### What happens to the results A screenshot, and a file that does not come back as text in the reply, is saved in the agent's workspace on the workspace computer. Squad removes the result from its own records some time after the request finishes. The request itself, with its reason and its outcome, stays in the list of recent requests. See [Limits and defaults](/docs/limits-and-defaults#squad-for-mac). On the **Runs** screen in the dashboard, each request shows as a tool call, for example "Asked to read a file on the owner's Mac", and each answer as a second row, for example "The owner's Mac answered" or "The owner declined a Mac request". The rows do not hold what your Mac sent. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.