OYNIX

Integrations / GitHub

Index every repo. Remember every why.

Oynix clones and parses your repositories at the AST level, then links each change to the pull requests and decisions behind it.

$ oynix connect github

Prerequisites

  • A GitHub personal access token with repo (read) scope.
  • The Oynix CLI installed and signed in (oynix login).

Setup steps

01

Install the Oynix CLI

Everything Oynix does runs from one small command-line tool on your own machine — there's nothing to deploy or host. Open your terminal (Terminal on Mac, PowerShell on Windows) and paste this in to install it:

$ curl -fsSL https://get.oynix.dev | sh
  • Don't have a terminal open? On Mac press ⌘+Space, type "Terminal", hit Enter.
  • Paste the line, press Enter, and wait for it to finish — that's it.
  • Check it installed: run oynix --version (it should print a version number).
02

Sign in

Tell Oynix who you are. This opens your browser to sign in with GitHub and links this computer to your workspace — it's how your edits, decisions and presence get attributed to you.

$ oynix login
  • Run the command; your browser opens automatically.
  • Approve the sign-in with GitHub, then return to the terminal.
  • If your team uses a workspace key, paste it when asked (a teammate with the master key issues it).
03

Create a GitHub token

A token is a password just for apps. You'll create one that lets Oynix read your repos (nothing else).

  • Go to github.com, click your avatar (top-right) → Settings.
  • Bottom-left: Developer settings → Personal access tokens → Tokens (classic) → Generate new token.
  • Tick the 'repo' scope, click Generate, and copy the token now — GitHub only shows it once.
04

Connect GitHub

Run the command and follow the prompts. Oynix walks you through it.

$ oynix connect github
  • When asked how to authorize, choose 'Direct' and paste the token you copied.
  • Enter the repo as owner/name — e.g. oynix-ai/oynix-indexer.
  • Choose what to index: code, pr (pull requests), or both.
05

Sync anytime

Oynix clones, parses and links the repo to the rest of your graph. Run this whenever you want to refresh it.

$ oynix connectors sync github
06

Check it worked

List your connectors to confirm GitHub shows up and is syncing. Once it's synced, ask the graph a question that should now have an answer from GitHub.

$ oynix connectors
  • You should see GitHub listed as "connected".
  • Try it: oynix ask "what did we decide about …?" — answers can now draw on GitHub.

What gets indexed

Code

Functions, classes, files and their call/dependency graph — AST-precise.

Pull requests

PR descriptions and reviews, linked to the code they changed.

History

Authorship and change history — who changed what, and when.