Skip to guide
Macaron Docs

Slack

Start threads from Slack and get the result back in the same Slack thread.

By Macaron

Set it up

In the desktop app, open Settings → Integrations and turn on Run threads on this Mac. In the Slack card, press Connect workspace: macaron.sh opens in your browser, you sign in if asked and approve Macaron in Slack. Back in the app, press Refresh and pick a default repository for the workspace, so requests don’t have to name one.

Start a thread

Ask Macaron in any of three ways. Name the repository with in owner/name, repo:owner/name or a github.com link; without one, the workspace’s default repository is used, and with neither Macaron asks which repository and you answer with owner/name in the thread.

  • Mention it in a channel: @Macaron fix the login redirect in acme/shop.
  • Send it a direct message.
  • Use /macaron fix the login redirect in acme/shop. Macaron posts your request in the channel and works in a thread under it. In a private channel, invite it first with /invite @Macaron.

Follow along

Macaron keeps one status message in the Slack thread up to date: waiting for a Mac, working on it and on which Mac, then done, failed or stopped. When it finishes it posts the summary, how many files changed, an Open pull request button and the screenshots and recordings the agent took as proof.

Follow up or stop

Reply in the Slack thread to send a follow-up to the agent: in a direct message any reply works, in a channel mention @Macaron in the reply. Macaron adds an eyes reaction when it passed your reply on. Say stop, or press Stop on the status message, to stop the agent. After a thread is done, a new request in the same Slack thread starts a new thread.

Good to know

Anyone in a connected workspace who can mention Macaron can start threads that run on your Mac with your GitHub access, so connect only workspaces you trust. Macaron reads only messages that mention it, direct messages to it and /macaron; it does not read the rest of your channels. Questions the agent asks while it works, such as approvals, are answered in the Macaron app. To disconnect, use the bin button in the Slack card, then remove the app in Slack under Manage apps.