Tutoriel Cursor Origin : configuration CLI, mirroring GitHub et pull requests

Qu'est-ce que Cursor Origin ?

Cursor Origin est une forge Git. Elle héberge des dépôts, réalise des miroirs de projets GitHub et prend en charge les pull requests et la navigation dans le code. Les dépôts Origin fonctionnent également avec les agents cloud et les automatisations de Cursor.

Quelle est la différence entre Cursor Origin et GitHub ?

Origin ne couvre pas toutes les fonctionnalités de GitHub. Les dépôts publics ne sont pas documentés, et les miroirs excluent les Issues GitHub, les workflows GitHub Actions et les secrets Actions. GitHub reste la plateforme la plus large pour les dépôts publics, les Issues, les Actions et les apps tierces ; aujourd'hui, Origin est un service plus ciblé.

La principale différence se situe sous le flux Git familier : Cursor a conçu une couche de stockage séparée pour le volume de branches et de commits produits par les agents. Cursor appelle cet axe « agent scale » : des charges où de nombreux agents créent des branches, commitent et ouvrent des pull requests sur le même dépôt.

Pourquoi Cursor a-t-il construit son propre hôte Git ?

La conception du stockage explique pourquoi Cursor a bâti un nouvel hôte Git plutôt que d'ajouter une interface à un hôte existant.

L'article d'ingénierie sur Continuity de Cursor décrit les hôtes Git existants comme conservant un dépôt sur plusieurs serveurs et validant un push après accord de la majorité. Cursor indique que ce modèle coûte davantage lorsqu'un système gère des milliers de dépôts éphémères ou des pushes fréquents vers un même dépôt.

Comment fonctionne le stockage Continuity de Cursor Origin ?

Continuity, ou « Cnt », est le système de stockage derrière Origin. Il enregistre un write-ahead log dans un stockage objet compatible S3 comme source de vérité. Le dépôt Git sur disque local sert de cache tiède reconstruisible à partir du journal.

Continuity stocke les écritures Git sous forme d'objets. Image par l'auteur.

Parce que le journal d'objets est l'enregistrement référent, Cursor peut ajouter des réplicas de lecture pour les dépôts très sollicités et les retirer quand la demande baisse. Dans les tests de Cursor, le débit en lecture augmentait avec les réplicas, jusqu'à 100 réplicas. Le système a géré jusqu'à 120 pushes par seconde sur un S3 standard, mais ces chiffres n'ont pas été validés par un benchmark indépendant.

Pour l'utilisateur, l'effet principal est plus simple : un dépôt très actif peut gagner en capacité de lecture, tandis qu'un dépôt éphémère n'exige pas une copie locale permanente sur chaque serveur.

Qui peut accéder à Cursor Origin ?

Origin est disponible sur les offres Pro, Teams et Enterprise, mais pas sur l'offre gratuite. Le déploiement est progressif : un forfait éligible n'assure pas que l'onglet Codebase apparaisse immédiatement. Sur Pro, vous possédez un espace de noms individuel et réservez votre nom de codebase.

Les administrateurs Enterprise peuvent le désactiver pour leur organisation. La vue d'ensemble de Cursor indique que n'importe quel membre peut réserver le premier nom de codebase, tandis que la page Codebase Settings précise qu'un admin équipe doit le faire. Vérifiez ce droit dans votre équipe avant la configuration.

Qu'est-ce que la CLI Cursor Origin ?

Origin fournit son propre outil en ligne de commande pour l'authentification, les dépôts, les pull requests et la configuration du compte.

CLI Cursor Origin vs. CLI Cursor Agent

La CLI d'Origin est un binaire séparé, origin, différent de la CLI de l'Agent Cursor, exécutée en agent.

Les noms se confondent facilement : origin est aussi le nom conventionnel d'un remote Git. Dans cet article, « push vers origin » désigne le remote Git, tandis que « exécuter origin » renvoie à la CLI.

Sur quelles plateformes la CLI Origin est-elle disponible ?

Cursor documente macOS, Linux et Windows via WSL. Lors de mon test, Windows signifiait WSL faute d'installateur natif.

Si vous suivez sous Windows, ouvrez le terminal Ubuntu avant d'installer la CLI. Lancer l'installeur shell dans PowerShell ne produit pas la même configuration.

Commandes de la CLI Cursor Origin

La CLI Cursor Origin comporte actuellement neuf groupes de commandes.

La plupart des commandes de dépôt lisent la cible depuis le remote Git nommé origin. L'option -R owner/repo définit la cible directement, utile dans un script qui peut s'exécuter sur plusieurs dépôts. Les commandes ruleset n'affichent que les règles de push et de merge existantes ; elles ne les modifient pas.

Comment installer et se connecter à la CLI Cursor Origin

Cursor distribue la CLI via un script shell plutôt que par un gestionnaire de paquets. La commande se trouve sur la page d'installation de Cursor.

Comment installer la CLI Cursor Origin

L'installation tient en une ligne :

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

L'installeur a placé origin à ~/.local/bin/origin. Si votre équipe relit les scripts d'installation avant exécution, téléchargez d'abord le script au lieu de le chaîner directement à sh.

Corriger l'erreur « command not found » de la CLI Origin

Si votre shell ne trouve pas origin après l'installation, ajoutez son répertoire au PATH :

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

Remplacez ~/.zshrc par ~/.bashrc sous bash. C'est un correctif à faire une seule fois par machine.

Vérifier l'installation et la connexion

Exécutez origin --version et origin --help pour confirmer l'installation, puis utilisez origin auth login pour ouvrir le flux de connexion via navigateur de Cursor.

Voici à quoi ressemblait la sortie de vérification dans WSL :

Version et aide de la CLI Origin. Image par l'auteur.

Dans un environnement sans interface graphique, la CLI affiche plutôt une URL. La connexion configure aussi l'assistant d'identifiants Git, de sorte que les remotes Origin fonctionnent sans jeton Git distinct. Lancez origin auth status ensuite pour vérifier la session.

Utiliser une clé API Cursor sans navigateur

Pour la CI ou des scripts, exécutez origin auth login --api-key <key> ou définissez CURSOR_API_KEY avant origin auth login. Ne stockez jamais la clé dans des fichiers versionnés. CURSOR_AUTH_TOKEN est différent et attend un bearer token.

Comment créer, cloner et pousser un dépôt Cursor Origin

Après connexion, vous pouvez créer un dépôt depuis l'interface web ou la CLI. Les pushes utilisent les commandes Git standards.

Créer un dépôt avec origin repo create

Depuis cursor.com/codebase, sélectionnez New, saisissez un nom et choisissez la visibilité Internal ou Private.

Depuis la CLI, origin repo create my-project utilise l'espace de noms de votre compte. Ajoutez un propriétaire, par ex. origin repo create acme/my-project, pour un espace de noms d'équipe. Le flag optionnel --default-branch modifie la valeur par défaut du serveur, main.

La commande origin repo clone acme/my-project clone le dépôt en HTTPS en réutilisant la connexion enregistrée par la CLI.

Pousser votre premier commit vers Origin

Après le premier push, le dépôt apparaît dans Codebase :

Dépôt poussé et visible dans Codebase. Vidéo par l'auteur.

Pour un dépôt tout juste créé et vide, clonez-le, ajoutez un fichier et poussez :

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

Si Git signale une erreur de permission sur .git/config.lock sous /mnt dans WSL, clonez plutôt sous ~. Cela a résolu l'erreur lors de mon test.

Après le push, ouvrez Codebase et vérifiez que le commit est visible. L'onglet Code affiche l'arborescence et l'historique. Appuyez sur T pour Go to file, ou utilisez le champ de recherche pour explorer le code.

Pousser un dépôt Git existant vers Origin

Si vous avez déjà un projet avec un historique Git, lancez d'abord git remote -v. La commande ci-dessous ne s'applique que si le dépôt n'a pas déjà un remote nommé origin :

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

Si origin pointe déjà vers GitHub, utilisez un autre nom de remote, par exemple cursor, au lieu d'écraser l'URL existante. Les commandes de la CLI Origin n'inféreront pas le dépôt depuis ce nom ; passez donc -R owner/repo en les exécutant.

Comment mettre en miroir un dépôt GitHub dans Cursor Origin

Un miroir copie un projet GitHub existant dans Origin et maintient la connexion entre les deux services.

Prérequis pour le mirroring GitHub dans Cursor Origin

Vous aurez besoin de l'accès à Origin, de l'application GitHub Cursor connectée à l'organisation ou au compte propriétaire du dépôt, et des droits admin sur ce dépôt GitHub. Les droits d'écriture seuls ne suffisent pas.

Démarrer un miroir GitHub dans Cursor Origin

Depuis cursor.com/codebase, sélectionnez Sync from GitHub, choisissez l'organisation et le dépôt, puis confirmez. L'alternative CLI est origin repo create-mirrored owner/repo, comme expliqué dans la documentation de mirroring de Cursor.

Ce que Cursor Origin met en miroir depuis GitHub

Origin met en miroir les données Git, mais pas toutes les fonctionnalités GitHub :

GitHub Actions continue de s'exécuter sur GitHub. Les intégrations Depot et Buildkite s'appliquent aux dépôts hébergés sur Origin, pas aux copies en miroir.

Quand GitHub reste la source de vérité

Tant qu'un dépôt est en miroir, les pushes via Origin transitent vers GitHub. Detach from GitHub, dans les Paramètres du dépôt, rend la copie Origin autonome sans modifier le dépôt GitHub.

Comment ouvrir et relire une pull request Cursor Origin

Les pull requests Origin reprennent la même séquence branche / push / revue que sur d'autres hôtes Git. Notre guide sur le fonctionnement des pull requests détaille cette séquence.

Créer une branche et pousser une modification

Créez et poussez la branche de travail :

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 a fait sa part ; la commande suivante relève d'Origin.

Ouvrir une pull request avec la CLI Origin

Les commandes liées au dépôt déduisent la cible du remote Git nommé origin. Exécutez origin pr create, ou passez -R owner/repo pour définir le dépôt directement. Par défaut, la commande crée un brouillon ; utilisez --status open pour une PR prête à la relecture.

Relire une pull request Cursor Origin

La CLI inclut origin pr list, origin pr view, origin pr diff et origin pr checks. Sans application de CI configurée, origin pr checks a affiché No checks reported. et s'est terminé avec le code 1 lors de mon test.

Ce code de sortie compte dans les scripts shell qui utilisent set -e, car un onglet Checks vide peut stopper le script même si la pull request est correcte.

Revue de pull request avec quatre onglets. Image par l'auteur.

Dans la vue web, chaque pull request comporte quatre onglets : Activity, Commits, Checks et Files Changed, avec en plus les demandes de reviewers, les commentaires en ligne et un bouton de merge. La page indique les conflits de fusion, et origin pr status --conflict-status les signale depuis le terminal.

Le terminal permet aussi origin pr merge. Les pull requests créées sur un dépôt hébergé par Origin restent sur Origin, tandis que l'activité sur un dépôt en miroir est renvoyée vers GitHub.

Accès équipe et permissions des dépôts Cursor Origin

Les permissions Origin existent aux niveaux codebase et dépôt.

Paramètres de la codebase vs. paramètres du dépôt

Les paramètres de la codebase sont à l'échelle de l'équipe : qui peut activer Origin, créer des dépôts et installer des applications. Les paramètres de dépôt s'appliquent à un seul dépôt et couvrent General, Permissions, Rules and Protections et Apps, même si la doc Cursor prévient que les écrans Permissions et Rules sont en refonte.

Si un coéquipier peut utiliser Origin mais ne peut pas ouvrir un dépôt, vérifiez les permissions de ce dépôt plutôt que les paramètres globaux d'équipe.

Dépôts Internal vs. Private

Deux types de dépôts ont un accès restreint :

• Internal repositories sont visibles par les membres de l'équipe ayant accès à la codebase.
• Private repositories ne sont visibles que par les membres auxquels l'accès est accordé directement ou via les permissions de la codebase. Passer un dépôt en private conserve en admin la personne ayant fait la modification.

Comment vérifier l'accès à un dépôt Cursor Origin

La commande origin repo list affiche tous les dépôts visibles pour le compte courant. Pour voir qui accède à un dépôt, ouvrez Settings, puis Permissions.

Bonnes pratiques avec Cursor Origin

Trois points sont essentiels à garder en tête avec Origin :

• Avant de supprimer ou reconfigurer un dépôt, confirmez la valeur complète owner/repo et inspectez ses remotes.

• Évitez -y tant que la cible n'est pas vérifiée.

• Les pages de permissions Cursor ne sont pas toujours cohérentes ; vérifiez la doc à jour avant d'automatiser des changements d'accès.

Cursor Origin vs. GitHub : comparaison des fonctionnalités

Origin est lié aux workflows d'agents de Cursor, tandis que GitHub couvre un écosystème de dépôts plus large.

Hébergement Git, pull requests et CI/CD

Plutôt que de répéter chaque section, voici la version courte de la répartition des fonctions :

La ligne sur les agents est celle qui demande du contexte.

Cursor Origin vs. GitHub pour les workflows d'agents

Les deux plateformes permettent aux agents d'interagir avec les dépôts. Origin garde cette boucle au sein de Cursor ; GitHub l'offre via son panneau Agents et ses outils Copilot, y compris la CLI généralement disponible.

Quand utiliser Cursor Origin, GitHub, ou les deux

• Utilisez Origin si le dépôt est internal ou private, que la majorité des travaux d'agents se fait déjà dans Cursor, et que votre déploiement ou votre CI peut tourner via Vercel, Depot ou Buildkite.
• Conservez GitHub comme hôte principal si le projet est public, que les Issues et Actions font partie du quotidien, ou que l'équipe dépend de la marketplace GitHub.
• Utilisez les deux si vous souhaitez la navigation de code et les workflows d'agents d'Origin sans déplacer le dépôt source. Un miroir conserve les pushes et l'activité de pull requests liés à GitHub tout en rendant le même code disponible dans Origin.

Conclusion

Je suis passé d'une installation WSL vierge à une pull request ouverte sur Origin en utilisant le même flux branche / commit / push qu'avec GitHub. La CLI n'a pas changé la façon dont Git fonctionne ; les différences d'Origin se situent côté hébergement, permissions et mirroring.

Après usage, je considérerais Origin comme un compagnon de GitHub, pas un remplaçant total. Le mirroring est l'entrée la plus pratique pour un dépôt existant, car GitHub peut rester la référence. Les projets publics et les workflows très dépendants d'Actions ont encore peu de raisons de bouger.

Pour aller plus loin, notre guide de Cursor Automations couvre les tâches d'agents exécutées sur un dépôt existant. Notre guide sur ce qu'est GitHub et comment l'utiliser explique en détail le workflow GitHub.