Beacon documentation

Last updated: 2026-09-17

Beacon puts a report button in your macOS or iOS app. Testers use it to send bugs, feature requests and feedback, and a Claude session works each report by a written triage policy.

Getting Beacon

Pick one of three ways.

• The plugin. In Claude Code, run the two commands below, then ask Claude to "set up Beacon in my app". The beacon-setup skill walks one of the setup paths with you, and beacon-triage works the reports. The plugin carries the whole repository.

/plugin marketplace add Up-Coast/beacon
/plugin install beacon@up-coast

• The Swift package. Add https://github.com/Up-Coast/beacon.git from version 0.2.3. The Quickstart shows the code. You still need a setup path so reports go somewhere.
• A clone. The setup pages assume the repository is at ~/beacon.

git clone https://github.com/Up-Coast/beacon.git ~/beacon

Two setup paths

Choose one per app. Every account, token and page involved is yours.

	Claude-only path	GitHub path
Fits	A team with a Claude organization that does not use GitHub	A team that tracks work in GitHub
Reports go to	Your Beacon page, a Claude artifact	Labelled issues in your repository
Testers report from	The Beacon page, opened by the button in your app	The in-app sheet, the Beacon page, or both
Testers need	Access to your Beacon page	For the sheet, a GitHub account with access to the repository. For the page, access to the page.
A report carries	App and device details from the link, plus what the tester writes and the images they add	From the sheet, also the app's log, settings, folder layout, screenshots, a screen recording and files
The board	Included	Optional
Setup	Setup: the Claude-only path	Setup: the GitHub path

On both paths a Claude session picks reports up, works them by the triage policy, and records an outcome on every report. What is collected lists everything a report carries.

Set up a new app

1. Set up a path: Claude-only or GitHub.
2. Put the button in your app: Quickstart.
3. Send the testers For testers.
4. Watch reports arrive on the board.

Pages

Page	Read it when
Quickstart	You want the button in your app now.
Setup: the Claude-only path	You have a Claude organization and do not use GitHub.
Setup: the GitHub path	You track work in GitHub and want issues and the in-app sheet.
How it works	You want to know what happens after a tester presses send.
The board	You want to see every report and its outcome.
What happens to a report	You want to know what Claude does with a report, and what it never does.
What is collected	You need to tell testers what a report contains.
Options	You want every configuration field, transport and flag.
For testers	You want the page to send to your testers.
FAQ	You want short answers to common questions.

Requirements

• An app for macOS 26 or iOS 26 or later.
• Xcode with the macOS 26 and iOS 26 SDKs, and Swift 6.2 or later.
• Claude Code, to run the pickup and, on the Claude-only path, to publish the page.
• On the GitHub path: a GitHub repository you administer, and the gh command-line tool signed in with access to it.