ChatAgain user guide

For someone who has just installed ChatAgain. Each part is short. For a quick fix, or to reach us, see Support.

  1. Before you start
  2. Your first message
  3. Your calendar, reminders, contacts and location
  4. Files, pictures and web pages
  5. Choosing a folder
  6. Adding tool sources
  7. Chats
  8. For IT: audit logs
  9. Limits and messages
  10. Deleting your data
  11. Still stuck?

1. Before you start

ChatAgain needs a Mac with Apple silicon, macOS 27 or later, in a region where Apple offers Private Cloud Compute. There is nothing to turn on first.

2. Your first message

Open ChatAgain and type a message. There is no sign-up and no model to download. Try "What time is it in Tokyo?"

ChatAgain with a first message and its answer
A first message and its answer.

3. Your calendar, reminders, contacts and location

The first time a message needs one of these, ChatAgain shows a card in the chat, and then macOS asks for your permission. Choose Not Now on the card to skip it. ChatAgain uses these only when a question needs them.

The card in the chat that asks to use your calendar
The card ChatAgain shows before macOS asks.
The macOS prompt asking to allow calendar access
The macOS permission prompt.

To turn a permission off later, open System Settings > Privacy & Security, choose Calendars (or Reminders, Contacts or Location Services), and switch ChatAgain off.

System Settings, Privacy and Security, Calendars, with ChatAgain listed
Turning a permission off later.

4. Files, pictures and web pages

Attach with the paperclip, by dragging into the window, or by pasting. ChatAgain reads pictures and screenshots, PDF, Word (.docx), plain text, Markdown, CSV, TSV, JSON, HTML and RTF. Pictures inside a Word file are left out. It cannot read older Word files (.doc), Excel, PowerPoint, Pages, Numbers or Keynote yet. Attaching one shows a note saying so. Save it as a PDF, or as CSV for a spreadsheet, and attach that.

The paperclip button and an attached PDF in the composer
Attaching a file with the paperclip.

To ask about a web page, paste its address and ask. ChatAgain reads that page and answers from what it finds. It does not search the web on its own.

A pasted web address and the reply that read the page
Pasting a link and asking about the page.

5. Choosing a folder

You pick the folder ChatAgain can see. Click the folder button in the toolbar, click Add Workspace…, and pick a folder.

The folder button's panel in the toolbar, with Add Workspace
The folder button's panel.
The macOS folder picker choosing a sample folder
Choosing a folder.
The approval prompt before ChatAgain edits a file
The approval before a file is changed.

6. Adding tool sources

A tool source is a server that gives ChatAgain extra tools, using the Model Context Protocol (MCP). It can be on the internet or running on your own Mac. There are two ways to add one: a quick card in the chat, or the Tool Sources window, which also manages the sources you have. Either way, the source ends up in the same list.

For a server on your own Mac, the address is something like http://localhost:3000/mcp. ChatAgain uses servers that are already running. It does not start programs for you.

Quick add: Chat > Add Tool Source…

Choose Chat > Add Tool Source… (Shift-Command-K). A card opens in the chat:

  1. Enter the server's web address and, if you like, a name for it.
  2. Under Sign-in, leave Sign in if it asks for most servers: your browser opens if the server wants you to sign in. Choose Access token for a server that gives you a token to paste instead.
  3. Tick Trusted only for a server you know, such as an official one. A trusted source's tools run without asking, except tools that say they can delete. Untrusted, every tool call checks with you first. You can change this later.
  4. Click Add. A note then says how many tools the source has and, going by its own labels, how many will run without asking.

The same card appears when you write a message about adding a server, such as "Add the Deepwiki MCP server: https://mcp.deepwiki.com/mcp". If you meant to ask the assistant something instead, click Send as a Message.

The Add a tool source card with a web address
The Add a tool source card, in the chat.

The Tool Sources window

Click Tool Sources (the puzzle piece) in the toolbar, or choose Chat > Tool Sources…. Add a server at the top adds a source like the card does, and handles two cases the card does not:

Below it are the sources you have. Open one to trust it or not, choose whether it checks with you before a tool runs, turn single tools off, check its connection, or remove it.

The Tool Sources window
The Tool Sources window: add a server, and manage the ones you have.

If a source stops working, open Tool Sources and click Check connection. It tests the address and asks you to sign in again if it needs to.

When it checks with you

Before a tool source's tools run, ChatAgain checks with you. You can trust a whole source, or allow one tool, in the source's settings, or with Always Allow This Tool when it asks. It still asks before a tool sends out text it read from a file, a page or a picture.

The approval prompt for a tool source call
Approving a tool source's call.

When a tool source changes its tools

A tool source can change its tools after you add it. ChatAgain remembers the tools you accepted and compares them each time it connects. A tool's description matters most, because it is text the assistant reads, and the place where hidden instructions would go.

A change you have not accepted is shown again each time the source connects. It never quietly becomes the new normal.

A card listing three tools whose descriptions a tool source changed, with Accept Changes and Reject
A tool source changed its tools' descriptions.

7. Chats

8. For IT: audit logs

An organization can turn on audit logs through MDM, for any install. Nothing is logged unless it does, and the person using the Mac cannot turn it on or off. Settings says so while it is on.

9. Limits and messages

Apple limits how many Private Cloud Compute requests each person can make per day. An orange notice means you are close. A red one means you have reached it, and it shows when it resets. Your chats stay readable. The limit is Apple's, and the same for everyone.

The orange and red notices about the daily limit
The daily limit notices.

If ChatAgain says Private Cloud Compute is not available, check the requirements in Before you start, make sure you are online and signed in with your Apple Account, and click Try Again.

10. Deleting your data

11. Still stuck?

Read Support, or email neuron@thisbrain.ai.