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 githubPrerequisites
- A GitHub personal access token with repo (read) scope.
- The Oynix CLI installed and signed in (oynix login).
Setup steps
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).
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).
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.
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.
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 githubCheck 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.