PapayaPapaya
Docs / Connect your code

Connect your code to Papaya

With your code, Papaya finds problems in how your agents are built, such as an agent that isn’t set up properly or a configuration that hurts its results. It also reads your code together with your traces, so each improvement points to the exact place to change and comes with a fix you can review and ship. If you approve it separately, Papaya can also open pull requests with those fixes.

You connect your code by installing the Papaya Code Analysis app on GitHub.

  • About five minutes to install
  • Read-only access
  • No passwords or keys shared
Install the GitHub appSee the steps first

What Papaya can and can’t access

Papaya can
  • Read the files and commit history of the repositories you select.
  • Read basic details about those repositories, such as their names and branches. GitHub requires this for every app.
Papaya can’t
  • Change your code, push commits, or open pull requests, unless you approve that separately.
  • See issues, pull requests, Actions, or settings.
  • See any private repository you don’t select.
You don’t give Papaya a password or a key. Each time Papaya reads your code, GitHub gives it a temporary, read-only token that expires on its own.

You can change which repositories Papaya can read, or remove its access, at any time. See how to change or remove access.

Before you start

  • Your repositories need to be on GitHub.com.

    If you use GitHub Enterprise Server, GitLab, or Bitbucket, contact us first.

  • The install is easiest for an organization owner.

    If you’re not an owner, you can still start it, and GitHub will ask your owners to approve it.

  • Check for an IP allow list.

    If your organization limits GitHub access by IP address, contact us before you install.

Install the app

  1. Open the install page and sign in to GitHub if asked.

    github.com/apps/papaya-code-analysis/installations/new

  2. Pick the organization (or personal account) that owns your agent code.

  3. Under Repository access, choose Only select repositories. Then pick the repositories that hold your agent code:

    • Prompts
    • Tool definitions
    • Model settings
    • The code that runs the agent
    • Shared libraries your agents use

  4. Check the permissions GitHub shows: Read access to code and metadata. Click Install.

    If the button says Install & Request or Request, an owner has to approve the request first. We can start once they do.

Send us these details

After you install the app, we can see your organization and the repositories you selected. We only need two things from you:

  1. For each of your agents in Papaya, which repository holds its code. If one repository holds several projects, also tell us the folder.
  2. The branch that runs in production, if it isn’t the repository’s default branch.
Email the detailsOr reply to the email we sent you.

How we use your code

  • We read your code only to analyze your agents for you.
  • We read the version of your code that matches your traces.
  • Your improvements may include short excerpts of your code, such as the lines to change.

Questions?

Write to us, or reply to the email we sent you.

Email support@papaya.fyi