# Rolling out Excellent to a team

> Set it up one Mac at a time, turn protections on, look once a week, and how an engagement with us works.

Excellent runs on each person's Mac. That means a team sets it up one Mac at a time. This guide is the order we would
work in, and what to expect.

## Before you start

Each Mac needs:

- Apple silicon (M1 or later) and macOS 14 or later.
- The agents your team already uses.

Scanning is free on every Mac. The live check, the sandbox and notifications need Pro on each Mac. Team engagements that
pair with us include Pro. [Free and Pro](https://www.excellent.so/docs/free-and-pro) says what each does.

There is no admin console yet. No settings are managed from one place, and there is no single sign-on. Installing with a
device management tool is not supported. Each Mac is set up on its own.

Choose one pilot owner and one developer who agrees to try it on their Mac. Decide who may see the pilot notes. Keep
session contents and findings with the developer unless they agree to share a redacted example. Pick one question to
answer, such as whether they can find the session behind a file change or verify one folder rule. Give the pilot owner
a date to review the result and decide whether to try another Mac.

## Step 1: install it on one Mac

Start with one Mac, yours.

Get the disk image from the [download page](https://www.excellent.so/download) and drag **Excellent** into **Applications**.
[Install the Mac app](https://www.excellent.so/docs/install) has the details.

## Step 2: read the first scan with the person whose Mac it is

Excellent scans as soon as it opens. Each finding says which agent, where and when. Read them together. It is their
Mac and their work. [Your first scan](https://www.excellent.so/docs/first-scan) says how to read it.

## Step 3: turn protections on

With Pro, press **Protect My Agents**. Excellent lists what it will change before it changes anything. Setup also asks
about protections that go further, such as the sandbox, each one already ticked. Some tasks may stop working with them
on, so go through them with the person.

Then it adds its check to each agent it found, backing up each settings file first. [Turn on protection](https://www.excellent.so/docs/turn-on-protection)
has the whole list, and how to take it back out.

## Step 4: share the rules

Press **Share…** so the agents that support it get the same rules. Excellent shows exactly what it will write first.

For rules the whole team keeps, write them in each repository's `CLAUDE.md` and `AGENTS.md`, and commit both. Those
travel with the repository, on any Mac. Rules in a person's own home folder stay on that Mac.
[One set of rules for your agents](https://www.excellent.so/guides/one-set-of-rules-for-your-agents) goes through it.

## Step 5: protect main, once per repository

Branch protection lives on GitHub or GitLab, so someone allowed to change a repository's settings sets it once for each
repository. On the Git page, **Protect Main…** sets it after you confirm. [Git protection](https://www.excellent.so/docs/git) says what it
changes and how to undo it.

## Step 6: look once a week

Today each Mac keeps its own findings, so there is no view across the team yet. Seeing your team's Macs and servers in one
view comes with Pro in January. It is planned, and it is not built yet.

Until then, make it a habit. Once a week, each person presses **Scan Now** and reads what is new. With Pro, Excellent also
sends a notification when something serious happens in between.

At the pilot review, ask the developer to show one result from the original task and identify any ordinary work the
protections interrupted. Review the undo steps with them and roll the changes back if the pilot ends there.
[Book a pilot discussion](https://www.excellent.so/hire/book) if you’d like to work through these steps together.

## Keep it up to date

Each Mac checks for a new version about once a day, and that can be turned off. [Updates](https://www.excellent.so/docs/updates) says what a check
sends. To take Excellent off a Mac, [Remove Excellent](https://www.excellent.so/docs/remove-excellent) says what it takes out and what it leaves
behind.

## How an engagement with us works

Our team can do all of this with yours. An engagement is priced by scope: a monthly fee for the hours of our time your
team needs, agreed in writing before the work starts, with no minimum term. It includes Pro. If you have one, copy your
pairing code from the client portal and enter it under **Settings → Pair with your team**. Pairing is optional, and it
links the app to your engagement.

[Enterprise](https://www.excellent.so/enterprise) says what we do and what the app does today. To get a price,
[book a call](https://www.excellent.so/hire/book) or email [hello@excellent.so](mailto:hello@excellent.so).

Source: https://www.excellent.so/guides/roll-out-excellent-to-a-team
