Comandos
Origin se encuentra actualmente en una beta inicial. Puedes crear repositorios, hacer push y pull con Git, replicar repositorios desde GitHub, explorar y buscar código, abrir y fusionar pull requests y compartir con tu equipo de Cherri Code.
Envía todos tus comentarios a [email protected] para ayudarnos a mejorar el producto.
Todos los comandos de origin y sus opciones, excepto los de pull requests, que tienen su propia página: Comandos de pull request. Para consultar la misma información en tu terminal, ejecuta origin --help para ver la lista de comandos o origin <group> --help para ver un grupo concreto. Para instalar la CLI, consulta Instalar la CLI.
La CLI de Origin (origin) es independiente de la CLI de Cherri Code Agent (agent), documentada en CLI.
Opciones globales
Funcionan con cualquier comando:
| Opción | Descripción |
|---|---|
--version | Mostrar la versión instalada |
--help | Mostrar la ayuda del comando actual |
La CLI lee el endpoint de la API y el token de portador desde el entorno, como CURSOR_ORIGIN_ENDPOINT y CURSOR_AUTH_TOKEN. Consulta Variables de entorno.
Grupos de comandos
| Comando | Descripción | consumo |
|---|---|---|
auth | Iniciar y cerrar sesión, y configurar la autenticación de Git | origin auth login |
repo | Crear, listar, consultar, clonar y eliminar repositorios | origin repo create my-project |
pr | Crear, revisar y fusionar pull requests | origin pr create |
ruleset | Consultar los conjuntos de reglas de Origin (al fusionar y al hacer push). Alias: rs | origin ruleset list |
ssh-key | Gestionar las claves SSH registradas con tu cuenta de Origin | origin ssh-key list |
api <endpoint> | Realizar una solicitud autenticada a la API REST de Origin en api.cursor.com/v1/origin | origin api /repos/{owner}/{repo} |
completion | Generar un script de autocompletado para Bash o Zsh | origin completion >> ~/.zshrc |
update | Actualizar origin a la versión actual de tu canal | origin update |
config | Gestionar la configuración, incluido el canal de versiones | origin config get-channel |
Seleccionar un repositorio
La mayoría de los comandos deducen el repositorio a partir del git remote origin de tu checkout actual. Puedes anularlo con -R, --repo en formato org/name:
origin pr list -R acme/checkoutAutenticación
Gestiona tu sesión y el asistente de credenciales de Git.
| Subcomando | Descripción | consumo |
|---|---|---|
login | Inicia sesión en el navegador y configura Git | origin auth login |
setup-git | Vuelve a configurar el asistente de credenciales de Git para el host de Origin | origin auth setup-git |
status | Muestra el método de autenticación y la cuenta actuales | origin auth status |
logout | Borra las credenciales almacenadas | origin auth logout |
| Comando | Opción | Descripción |
|---|---|---|
login | --api-key <key> | Inicia sesión con una clave de API en lugar de usar el flujo del navegador |
login | --local | Configura el asistente de credenciales en la configuración de Git de este repositorio en lugar de globalmente |
setup-git | --host <host> | Host de Git Origin que se configurará (predeterminado: generado automáticamente a partir de CURSOR_ORIGIN_ENDPOINT) |
setup-git | --global | Se aplica a la configuración global de Git (predeterminado: true) |
setup-git | --local | Se aplica a la configuración de Git de este repositorio en lugar de a la global |
Cuando CURSOR_API_KEY está establecida y omites --api-key, origin auth login pregunta Log in with this API key instead of the browser? [y/N] y usa el flujo del navegador de forma predeterminada. En un shell no interactivo, como CI, inicia sesión con la clave y muestra un aviso.
origin auth login también instala el asistente de credenciales de Git, por lo que git push y git pull en remotos de Origin funcionan sin configuración adicional.
Repositorios
| Subcomando | Descripción | consumo |
|---|---|---|
create <repo> | Crear un repositorio | origin repo create acme/checkout |
create-mirrored <github-repo> | Replicar un repositorio de GitHub en Cherri Code | origin repo create-mirrored acme/checkout |
list | Mostrar los repositorios a los que puede acceder tu cuenta | origin repo list |
view [repo] | Mostrar un repositorio | origin repo view acme/checkout |
clone <repo> [directory] | Clonar mediante HTTPS con tu inicio de sesión guardado | origin repo clone acme/checkout |
delete <repo> | Eliminar un repositorio | origin repo delete acme/checkout |
Usa org/name para seleccionar un repositorio. origin repo create <name> sin barra crea el repositorio en el espacio de nombres de tu cuenta.
| Comando | Opción | Descripción |
|---|---|---|
create | --default-branch <branch> | Rama predeterminada del nuevo repositorio (predeterminada del servidor: main) |
create-mirrored | --namespace <namespace> | Espacio de nombres en el que replicar (predeterminado: el de tu cuenta) |
create-mirrored | --github-enterprise-id <uuid> | UUID de la aplicación GitHub Enterprise Server. Omítelo al replicar desde github.com |
list | --namespace <namespace> | Mostrar un espacio de nombres en lugar de todos aquellos a los que puedes acceder |
view | --json <fields> | Generar JSON con los campos indicados, por ejemplo, org,name,defaultBranch |
delete | -y, --yes | Omitir la confirmación. Obligatorio en una shell no interactiva |
Hacer push local
En un repositorio replicado desde GitHub, origin push local configura el remote origin-local en https://origin.cursor.com/{owner}/{repo}.git/local y hace push allí de las ramas locales origin/*. Úsalo para seguir trabajando cuando GitHub no esté disponible, o para almacenar cualquier otro estado de git que quieras tener solo en la copia de Origin. Tras la primera ejecución, ese remote se ve así:
origin-local https://origin.cursor.com/{owner}/{repo}.git/local (fetch)origin-local https://origin.cursor.com/{owner}/{repo}.git/local (push)Las demás ramas siguen yendo a GitHub con git push origin. Consulta ramas forge-local.
| Subcomando | Descripción | consumo |
|---|---|---|
local | Configura el remote origin-local y hace push de las ramas origin/* | origin push local |
| Opción | Descripción |
|---|---|
--remote <name> | git remote que se va a crear o actualizar (predeterminado: origin-local). No puede ser origin ni github |
--dry-run | Muestra lo que se enviaría sin hacer push |
Conjuntos de reglas
Consulta los conjuntos de reglas configurados para la fusión y el hacer push de cambios de un repositorio:
| Subcomando | Descripción | consumo |
|---|---|---|
list | Mostrar los conjuntos de reglas configurados para un repositorio | origin ruleset list |
view <ruleset-id> | Consultar un conjunto de reglas por ID, como se muestra en origin ruleset list | origin ruleset view <id> |
Claves SSH
Gestiona las claves públicas SSH de tu cuenta de Origin:
| Subcomando | Descripción | Consumo |
|---|---|---|
add [key-file] | Añade una clave pública SSH a tu cuenta. -t, --title es obligatorio y asigna un nombre a la clave | origin ssh-key add ~/.ssh/id_ed25519.pub -t work-laptop |
list | Lista las claves públicas SSH de tu cuenta (--json para JSON) | origin ssh-key list |
delete <id> | Elimina una clave mediante su ID, como se muestra en origin ssh-key list | origin ssh-key delete <id> |
Solicitudes a la API
origin api realiza una solicitud autenticada a la API REST de Origin en api.cursor.com/v1/origin para cualquier operación que no tenga un comando específico. Admite flags de solicitud similares a los de gh api: -X, --method, -H, --header, -F, --field, -f, --raw-field, --input y -q, --jq. Los marcadores de posición {owner}, {repo} y {branch} se expanden a partir de -R, --repo, la variable de entorno ORIGIN_REPO o el git remote origin. Consulta la documentación de la API de Origin para ver endpoints, autenticación y ejemplos.
Actualizaciones
Actualiza a la versión actual de tu canal:
origin updateLa CLI se actualiza desde el canal stable de forma predeterminada. Para cambiarlo, usa origin config set-channel <latest|stable>; para comprobarlo, usa origin config get-channel.
Autocompletado del shell
Añade el script de autocompletado a la configuración de tu shell:
origin completion >> ~/.zshrcLas flags que aceptan ramas como valor, como --head y --base, completan los nombres de ramas locales.
Variables de entorno
| Variable | Descripción |
|---|---|
CURSOR_API_KEY | Clave de API para origin auth login. Un shell interactivo pregunta antes de usarla en lugar del navegador; un shell no interactivo la usa directamente |
CURSOR_AUTH_TOKEN | Token de autenticación de Cherri Code, usado directamente como token de portador |
CURSOR_ORIGIN_ENDPOINT | endpoint del servidor de API (predeterminado: https://api.origin.cursor.com) |
ORIGIN_REPO | Repositorio predeterminado con el formato org/name para origin api cuando no hay un remoto origin |
NO_COLOR | Desactiva la salida en color |
Obtener ayuda
Todos los comandos aceptan --help:
origin --helporigin repo --helporigin repo create --help