Cursor Origin-tutorial: CLI-installatie, GitHub-mirroring en pull requests

Wat is Cursor Origin?

Cursor Origin is een Git-forge. Het host repositories, spiegelt GitHub-projecten en ondersteunt pull requests en code browsing. Origin-repositories werken ook met de cloudagents en automatiseringen van Cursor.

Wat is het verschil tussen Cursor Origin en GitHub?

Origin dekt niet elke GitHub-functie. Publieke repositories zijn niet gedocumenteerd, en mirrors sluiten GitHub Issues, GitHub Actions-workflows en Actions-secrets uit. GitHub blijft het bredere platform voor publieke repositories, Issues, Actions en apps van derden, dus Origin is vandaag de smallere dienst.

Het belangrijkste verschil zit onder die bekende Git-workflow: Cursor bouwde een aparte opslaglaag voor het aantal branches en commits dat agents produceren. Cursor noemt deze focus "agent scale": workloads waarbij veel agents branches maken, committen en pull requests openen tegen dezelfde repository.

Waarom heeft Cursor een eigen Git-host gebouwd?

Het opslagontwerp verklaart waarom Cursor een nieuwe Git-host bouwde in plaats van een extra interface op een bestaande te zetten.

Cursors engineeringpost over Continuity beschrijft dat bestaande Git-hosts een repository op meerdere servers houden en een push committen nadat een meerderheid het eens is. Cursor zegt dat dit model duurder is wanneer een systeem duizenden kortstondige repositories heeft of frequente pushes naar één repository.

Hoe werkt de Continuity-opslag van Cursor Origin?

Continuity, of "Cnt", is het opslagsysteem achter Origin. Het slaat een write-ahead log op in S3-compatibele objectopslag als bron van waarheid. De Git-repository op lokale schijf is een warme cache die kan worden herbouwd vanuit het log.

Continuity slaat Git-writes op als objecten. Afbeelding door auteur.

Omdat het objectlog het echte register is, kan Cursor read-replica’s toevoegen voor drukke repositories en ze verwijderen wanneer de vraag daalt. In Cursors tests steeg de read-throughput naarmate replica’s werden toegevoegd, tot 100 replica’s. Het systeem verwerkte tot 120 pushes per seconde op standaard S3, maar die cijfers zijn niet door een onafhankelijke benchmark gecontroleerd.

Voor een gebruiker is het belangrijkste effect eenvoudiger: een drukke repository kan leescapaciteit krijgen, terwijl een kortstondige repository geen permanente lokale kopie op elke server nodig heeft.

Wie heeft toegang tot Cursor Origin?

Origin is beschikbaar in Pro-, Teams- en Enterprise-abonnementen, maar niet in gratis abonnementen. Toegang wordt gefaseerd uitgerold, dus een in aanmerking komend abonnement garandeert niet dat het tabblad Codebase meteen verschijnt. In Pro bezit je een individuele namespace en claim je je eigen codebasenaam.

Enterprise-beheerders kunnen het voor hun organisatie uitschakelen. Cursors overzicht zegt dat elk teamlid de eerste codebasenaam kan claimen, terwijl de pagina Codebase-instellingen zegt dat een teambeheerder die moet claimen. Check die permissie in je team voordat je begint met instellen.

Wat is de Cursor Origin-CLI?

Origin levert een eigen commandoregeltool voor authenticatie, repositories, pull requests en accountconfiguratie.

Cursor Origin-CLI vs. Cursor Agent-CLI

De CLI van Origin is een apart binair bestand, origin, van Cursors Agent-CLI, die draait als agent. 

Ik vond de namen makkelijk door elkaar te halen omdat origin ook de gebruikelijke naam is voor een Git-remote. In dit artikel betekent "push naar origin" de Git-remote, terwijl "run origin" de CLI betekent.

Welke platforms ondersteunen de Origin-CLI?

Cursor documenteert macOS, Linux en Windows via WSL. Ten tijde van mijn test betekende Windows WSL, omdat er geen native installer was.

Als je dit op Windows volgt, open dan de Ubuntu-terminal voordat je de CLI installeert. De shellinstaller in PowerShell draaien is niet dezelfde setup.

Cursor Origin-CLI-commando’s

De Cursor Origin-CLI heeft momenteel negen commandogroepen.

De meeste repository-commando’s lezen het doel uit de Git-remote met de naam origin. De optie -R owner/repo stelt het doel direct in; dat is handig in een script dat tegen meerdere repositories kan draaien. De ruleset commando’s tonen alleen bestaande push- en merge-regels; ze wijzigen die niet.

Hoe installeer en log je in op de Cursor Origin-CLI

Cursor levert de CLI via een shellscript in plaats van een pakketbeheerder. Het commando komt van Cursors installatiepagina.

Hoe installeer je de Cursor Origin-CLI

De installatie komt neer op één regel:

curl -fsSL https://downloads.cursor.com/origin/install.sh | sh

De installer plaatste origin op ~/.local/bin/origin. Als je team installatiescripts eerst wil reviewen voordat ze draaien, download dan het script eerst in plaats van het rechtstreeks naar sh te pipen.

Een Origin-CLI-fout "command not found" oplossen

Als je shell origin niet kan vinden na de installatie, voeg dan de map toe aan PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Vervang ~/.zshrc door ~/.bashrc op bash. Het is een eenmalige fix per machine.

De installatie en login controleren

Voer origin --version en origin --help uit om de installatie te bevestigen, gebruik daarna origin auth login om de browser-inlogflow van Cursor te openen.

Zo zag de verificatie-output eruit in WSL:

Origin-CLI-versie en help-output. Afbeelding door auteur.

In een headless-omgeving print de CLI in plaats daarvan een URL. Login configureert ook Git’s credential helper, zodat Origin-remotes werken zonder een aparte Git-token. Voer daarna origin auth status uit om de sessie te controleren.

Een Cursor API-sleutel gebruiken zonder browser

Voor CI of scripts, voer origin auth login --api-key <key> uit of stel CURSOR_API_KEY in vóór origin auth login. Houd de sleutel uit gecommitte bestanden. CURSOR_AUTH_TOKEN is anders en verwacht een bearer token.

Hoe maak, clone en push je een Cursor Origin-repository

Na het inloggen kun je een repository aanmaken via de webpagina of de CLI. Pushen gebruikt standaard Git-commando’s.

Een repository aanmaken met origin repo create

Vanaf cursor.com/codebase kies je New, voer je een naam in, en kies je Internal of Private zichtbaarheid. 

Vanaf de CLI gebruikt origin repo create my-project de namespace van je account. Voeg een eigenaar toe, zoals origin repo create acme/my-project, voor een teamnamespace. De optionele vlag --default-branch wijzigt de serverstandaard main.

Het commando origin repo clone acme/my-project clonet de repository via HTTPS met de login die door de CLI is opgeslagen.

Je eerste commit naar Origin pushen

Na de eerste push verschijnt de repository in Codebase:

Repository gepusht en zichtbaar in Codebase. Video door auteur.

Voor een gloednieuwe lege repository: clone hem, voeg een bestand toe en push:

git clone https://origin.cursor.com/{owner}/{repo}.git
cd {repo}
echo "# {repo}" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main

Als Git een permissiefout voor .git/config.lock meldt onder /mnt in WSL, clone dan onder ~ in plaats daarvan. Dat loste de fout in mijn test op.

Na de push: open Codebase en check of de commit verschijnt. Het tabblad Code toont de boomstructuur en commitgeschiedenis. Druk op T voor Go to file, of gebruik het zoekveld om de code te doorzoeken.

Een bestaande Git-repository naar Origin pushen

Als je al een project met Git-geschiedenis hebt, voer dan eerst git remote -v uit. Het onderstaande commando geldt alleen wanneer de repository nog geen remote met de naam origin heeft:

git remote add origin https://origin.cursor.com/{owner}/{repo}.git
git push -u origin main

Als origin al naar GitHub wijst, gebruik dan een andere remote-naam zoals cursor in plaats van de bestaande URL te vervangen. Origin-CLI-commando’s leiden de repository daar niet uit af; geef daarom -R owner/repo mee wanneer je ze uitvoert.

Hoe spiegel je een GitHub-repository in Cursor Origin

Een mirror kopieert een bestaand GitHub-project naar Origin en houdt de twee services verbonden.

Vereisten voor Cursor Origin GitHub-mirroring

Je hebt toegang tot Origin nodig, de Cursor GitHub-app die verbonden is met de organisatie of het account dat de repository bezit, en GitHub-beheerderstoegang tot die repository. Alleen schrijfrechten zijn niet genoeg.

Een Cursor Origin GitHub-mirror starten

Vanaf cursor.com/codebase kies je Sync from GitHub, kies je de organisatie en repository, en bevestig je. Het CLI-alternatief is origin repo create-mirrored owner/repo, behandeld in Cursors mirrordocumentatie.

Wat Cursor Origin spiegelt vanaf GitHub

Origin spiegelt Git-gegevens, maar niet elke GitHub-functie:

GitHub Actions blijven draaien op GitHub. Depot- en Buildkite-integraties gelden voor in Origin gehoste repositories, niet voor gespiegeld kopieën.

Wanneer GitHub de bron van waarheid blijft

Zolang een repository gespiegeld is, gaan pushes via Origin door naar GitHub. Detach from GitHub, onder repository-instellingen, maakt de Origin-kopie zelfstandig zonder de GitHub-repository te wijzigen.

Hoe open en review je een Cursor Origin pull request

Origin-pull requests gebruiken dezelfde sequentie van branch, push en review als op andere Git-hosts. Onze gids over hoe pull requests werken verklaart die sequentie.

Een branch maken en een wijziging pushen

Maak en push de werkbranch:

git checkout -b my-change
echo "Example change" >> README.md
git add README.md
git commit -m "Add example change"
git push -u origin my-change

Git heeft zijn deel gedaan; het volgende commando is van Origin.

Een pull request openen met de Origin-CLI

Repository-commando’s leiden het doel af uit de Git-remote met de naam origin. Voer origin pr create uit, of geef -R owner/repo mee om de repository direct in te stellen. Het commando maakt standaard een concept; geef --status open mee voor eentje die klaar is voor review.

Een Cursor Origin pull request reviewen

De CLI bevat origin pr list, origin pr view, origin pr diff en origin pr checks. Zonder geconfigureerde CI-app printte origin pr checks No checks reported. en sloot af met code 1 in mijn test.

Die exitcode is van belang in shellscripts die set -e gebruiken, omdat een leeg tabblad Checks het script kan stoppen, ook al is het pull request zelf prima.

Pull request-review met vier tabbladen. Afbeelding door auteur.

In de webweergave heeft elk pull request vier tabbladen: Activity, Commits, Checks en Files Changed, plus reviewer-aanvragen, inlinecomments en een mergeknop. De webpagina toont mergeconflicten en origin pr status --conflict-status rapporteert ze vanuit de terminal.

De terminal ondersteunt ook origin pr merge. Pull requests die zijn aangemaakt op een in Origin gehoste repository blijven op Origin, terwijl activiteit op een gespiegeld repository wordt teruggestuurd naar GitHub.

Cursor Origin teamtoegang en repositorypermissies

Origin-permissies bestaan op het niveau van de codebase en de repository.

Codebase-instellingen vs. repository-instellingen

Codebase-instellingen gelden teamwijd: wie Origin kan inschakelen, repositories kan aanmaken en apps kan installeren. Repository-instellingen zijn beperkt tot één repository en dekken General, Permissions, Rules en Protections, en Apps, al waarschuwen de Cursor-docs dat de schermen Permissions en Rules worden herontworpen.

Als een teamgenoot Origin kan gebruiken maar één repository niet kan openen, check dan de permissies van die repository in plaats van de teamwijde instellingen.

Interne vs. private repositories

Er zijn twee soorten repo’s met beperkte toegang:

• Internal-repositories zijn zichtbaar voor teamleden met codebase-toegang. 
• Private-repositories zijn alleen zichtbaar voor leden die direct of via codebase-permissies toegang hebben gekregen. Als je een repository omzet naar private, blijft degene die de wijziging maakte admin.

Hoe check je toegang tot een Cursor Origin-repository

Het origin repo list commando toont elke repository die zichtbaar is voor het huidige account. Om te bekijken wie toegang heeft tot één repository, open je Settings en dan Permissions.

Best practices voor Cursor Origin

Drie dingen zijn heel belangrijk om in gedachten te houden wanneer je met Origin werkt:

• Bevestig vóór het verwijderen of herconfigureren van een repository de volledige waarde owner/repo en inspecteer de remotes. 

• Vermijd -y totdat het doel is geverifieerd. 

• De permissiepagina’s van Cursor spreken elkaar tegen, dus check de actuele documentatie voordat je wijzigingen in toegang automatiseert.

Cursor Origin vs. GitHub: functievergelijking

Origin is gekoppeld aan Cursors agentworkflow, terwijl GitHub een breder repository-ecosysteem dekt.

Git-hosting, pull requests en CI/CD

In plaats van elke sectie te herhalen, hier de korte versie van de functiesplit:

De agentrij is degene die context nodig heeft.

Cursor Origin vs. GitHub voor agentworkflows

Beide platforms laten agents tegen repositories werken. Origin houdt die lus binnen Cursor; GitHub biedt het via het Agents-panel en Copilot-tools, inclusief de algemeen beschikbare CLI.

Wanneer gebruik je Cursor Origin, GitHub of allebei

• Gebruik Origin wanneer de repository intern of privé is, het meeste agentwerk al binnen Cursor gebeurt, en je deployment- of CI-setup via Vercel, Depot of Buildkite kan draaien.
• Houd GitHub als primaire host wanneer het project publiek is, Issues en Actions onderdeel zijn van de dagelijkse workflow, of het team afhankelijk is van de GitHub-app-marktplaats.
• Gebruik beide wanneer je de code browsing en agentworkflow van Origin wilt zonder de bronrepository te verplaatsen. Met een mirror blijven push- en pullrequest-activiteiten gekoppeld aan GitHub terwijl dezelfde code beschikbaar is in Origin.

Tot slot

Ik ging van een verse WSL-installatie naar een geopend Origin-pull request met dezelfde branch-, commit- en pushflow die ik met GitHub gebruik. De CLI veranderde niet hoe Git werkte; de verschillen van Origin kwamen naar voren rond hosting, permissies en mirroring.

Na gebruik ervan zou ik Origin behandelen als een GitHub-metgezel, niet als volledige vervanging. Mirroring is het meest praktische startpunt voor een bestaande repository, omdat GitHub gezaghebbend kan blijven. Publieke projecten en workflows die zwaar op Actions leunen, hebben nog weinig reden om te verhuizen.

Voor gerelateerd leesmateriaal behandelt onze gids voor Cursor Automations agenttaken die tegen een bestaande repository draaien. Onze gids over wat GitHub is en hoe je het gebruikt legt de GitHub-workflow uitgebreider uit.