Getting started

Install Yenpo and open your first repository

Check that your Mac is supported, install Yenpo, and read local code without a model account. Connect a provider only for AI questions.

You don’t need a model account to start reading code in Yenpo. Browsing, search, and language-server navigation all work locally. Connect a model provider later, when you want to ask the AI Reader about the code.

Check your Mac

Yenpo runs on both Apple silicon and Intel Macs with macOS 14 or later; one download works on either. You can check your macOS version in About This Mac.

Install

  1. Download the .dmg from the home page.
  2. Open it and drag Yenpo into Applications.
  3. Launch Yenpo from Applications, then eject the disk image.

Check the installed version

Choose Yenpo → About Yenpo in the menu bar. Compare the version with the one next to the download button.

If you installed an update but still see the old version, quit Yenpo and reopen the copy in Applications. See Update Yenpo for the replacement steps.

Open a project

Open the folder of the project you want to read. Pick the repository root, the folder that holds the README, the build file, and .git. If you open a subfolder instead, tests and configuration elsewhere in the repository won’t be part of the project.

Press Command-P (Go to File…), type part of a file name or path, and open a file you recognize. Keep the README or a related test open in another tab. To read a different project, open it in its own window.

Can’t find a file you know is there? Make sure it’s inside the folder you opened, then check whether hidden or Git-ignored files are being hidden. Find files and follow symbols has the details.

Try one small task

Pick something with an answer you can check, such as where a setting is read:

  1. Use Search All Files to find the exact setting name or a distinctive message.
  2. Open the matching function and find where it gets its input.
  3. Use Go to Definition or Find References if a language server is available. Otherwise, search for the symbol as text.
  4. Read the caller or test that supplies the input.

That’s enough to get going: an entry point, a value to follow, and a caller or test that shows how it’s used. You don’t need to understand the whole architecture first.

Ask the AI Reader (optional)

Set up a provider with Connect a model provider, then open the AI Reader and ask about the code you just read. You can add a file, folder, or selection as a starting point, or just describe the behavior and let it find the code in your workspace.

For example:

Trace this setting from its default value to the request handler. Which overrides can change it? Point me to the branches I should check.

Click a source reference in the answer to preview the code in Quick Look, and click Open File to keep it in a tab. Check one claim against the code before you ask a bigger question.

The AI Reader only reads by default. You can let it edit files for a single run; What gets sent and what can be edited explains how that works and what goes to the model.

Update Yenpo

  1. Choose Yenpo → Check for Updates…. If an update is available, click Download New Version to download the .dmg in your browser. If your version has no update menu, compare it with the version beside the home page download button and download the newer one there.
  2. Save any unsaved files, then quit Yenpo. Open the new disk image and drag Yenpo into Applications, replacing the existing copy when Finder asks.
  3. Launch Yenpo from Applications, check Yenpo → About Yenpo again, then eject the disk image.

Automatically check for updates is on by default. You can turn it off in Settings → General → Software Update. Automatic checks happen at launch or when Yenpo becomes active, at least 24 hours apart; downloading and installing remain manual.

If something doesn’t work

Problem Check first
A file can’t be found Project root, file path, hidden and Git-ignored file settings
Go to Definition does nothing Whether the language server is installed and understands the project
The AI Reader can’t answer Active provider, API type, endpoint, model ID, API key
The code isn’t what you expected Whether the tab shows a historical Git version or your current file

When recording a bug, keep your Yenpo and macOS versions, expected and actual results, and reproduction steps. Leave out private code and API keys from anything you share publicly.

Choose your next step

Continue with Find files, follow symbols, and check source references. Start with file search, then use symbol navigation when a language server is available. You can also compare commits and branches without a model account.

If you want to ask the AI Reader about the code, connect a model provider. Before sending a question, review what code is sent to the provider and the provider’s charges.