What is relatokit?

RelatoKit is a command-line tool for macOS that helps you prepare and submit bug reports and feature requests through Apple's Feedback Assistant app. Feedback Assistant is the official Apple tool that developers use to report issues with Apple operating systems, frameworks, and developer tools. Normally, filling out a Feedback Assistant report is a manual process involving the native app, category menus, file attachments, and text fields. RelatoKit automates the preparation work and can drive the native app using macOS Accessibility features. The name comes from the Portuguese word "relato," meaning report or account. The tool works in two stages. First, you run a prepare command with a title, description, optional screenshot or log file, the bundle identifier of the affected app, and the platform (macOS, iOS, visionOS, and others). RelatoKit writes two files: a JSON payload with the structured data, and a Markdown version for human review. Second, you run a submit command that opens the real Feedback Assistant app, fills in the text fields and popup menus using macOS Accessibility APIs, stages your attachment into the app's draft folder, and optionally presses the Submit button if you pass the confirmation flag. The tool never bypasses Apple's submission process. It fills in the native Feedback Assistant form and hands off to the actual app for the final submission. If you do not pass the confirmation flag, it stops before clicking Submit so you can review the form yourself. Some fields that Feedback Assistant generates automatically, such as diagnostic logs or device details, still require manual review inside the app before confirming. RelatoKit is also designed to work inside automated agent workflows, where an AI assistant or script prepares the report payload and the tool handles the native app interaction. It includes curated mappings for common Feedback Assistant topic areas and platforms so that categories can be inferred from a title and description without manual lookup. The tool requires macOS 14 or later, Swift 6, and the Feedback Assistant app already installed and signed in with an Apple ID. Accessibility permission must be granted for Terminal. It is built from source using Swift Package Manager and released under the MIT license.