Retra beta for Mac on TestFlight: a quick overview of the Swift file open in Xcode.

By Michael, 19 November, 2026

Forum
Developer Announcements

Hi all,

We're a team of six at the Apple Developer Academy, and Retra is our final project. It started with a simple question: how do you get the big picture of a Swift file before going through it line by line?

When VoiceOver reads code in Xcode, it reads from the top of the file to the bottom. Often you have to get through most of the file before you know what it's for, what's in it, and how it connects to the rest of the project. This is especially true for code someone else wrote, like a teammate's file or a starter project from a mentor. The usual workaround is to ask a friend, a mentor or an AI chat, which takes time and leaves a lot to keep in your head.

Retra gives you that picture first, right inside Xcode.

Open any Swift file in Xcode and press Command Option Shift O. Retra opens a small panel on top of Xcode with two layers:

- Overview 1: a few plain sentences on what the file is for.
- Overview 2: what's inside the file, one item per line. Press Command Return on a line to jump straight to that spot in Xcode.

Press Escape to step back, and you're returned to Xcode with your cursor where you left it.

The explanations are generated on your Mac with Apple Intelligence. The facts, such as type names, relations and line numbers, come from reading the code directly, so the app won't make up code that isn't there.

Before you install
- macOS 27, Xcode, and Apple Intelligence turned on
- The first time you use it, macOS asks whether Retra may control Xcode. Retra needs this to read the file you have open. It only reads your code and never changes it.
- A short setup walks you through the shortcut and both layers using a sample file, so you can try everything before opening your own project.
- Known rough edges: Clicking the Retra icon in the Dock may not bring the window Retra back. Press Command Option Shift R instead.

Join the beta
TestFlight link: https://testflight.apple.com/join/fmA8HPpC
This build is available until 30 November 2026, then you can access it on AppStore.

Where you can help the most

First, the flow. Go through the setup and then use Retra on a real project the way you naturally would. Where did things feel smooth, and where did you have to stop and work out what to do next? Focus, the order things are read in, labels, the shortcut and moving between Retra and Xcode are all fair game.

Second, the purpose. After using it on a few files, does Overview 1 tell you something you didn't know yet? Is Overview 2 a faster way around a file than what you do now? Would you reach for Retra again, and what feels missing or unnecessary?

Sharing your thoughts
Reply in this thread or use the feedback option in TestFlight. A one-line note is just as welcome as a long write-up. If something is broken, we'd much rather hear it now.

Thanks for your attention.
Michael, on behalf of the Retra team.

Options