Ir al contenido
Documentation

CLI Referencia de comandos

Ejecutar champrep --help y champrep COMMAND --help para conocer los parámetros exactos que incluye la versión instalada. Esta página resume el árbol de comandos público actual.

OpciónObjetivo
--env NAMEAnular el entorno de Gateway activo para un comando.
--profile IDUtilice otra cuenta almacenada para un comando sin cambiar la cuenta activa.
-v, --verboseRegistrar los metadatos de las solicitudes y respuestas con el encabezado de autorización ocultado.
--debugAñada los cuerpos de las solicitudes y respuestas a la salida de diagnóstico. Úselo con precaución cuando se trate de datos confidenciales.
--jsonGenerar JSON legible por máquina cuando sea compatible.
--no-colorDesactivar el color ANSI. El tambiénCLI respeta NO_COLOR.

Coloque indicadores persistentes antes o después de un subcomando, tal y como lo admite la versión instalada. Prefiera --json para la automatización.

ComandoObjetivo
champrep auth loginIniciar sesión mediante la autorización del navegador.
champrep auth login --no-browserImprimir una URL de aprobación para un terminal remoto.
champrep auth tokenAlmacenar una claveAPI con ámbito en el llavero del sistema operativo.
champrep auth whoamiMostrar la identidad y el perfil activos.
champrep auth statusMostrar la identidad, la cuota en tiempo real y el contexto de auditoría disponible.
champrep auth listMostrar una lista de los perfiles almacenados en todos los entornos.
champrep auth switch PROFILESeleccionar otro perfil almacenado para la misma cuenta.
champrep auth logoutEliminar las credenciales locales actuales y el estado del perfil.
ComandoObjetivo
champrep drive ls [REMOTE_PATH]Mostrar los archivos de una carpeta.
champrep drive tree [REMOTE_PATH]Mostrar un árbol de carpetas recursivo.
champrep drive cp SOURCE DESTTransferir un archivo entre el equipo local y Drive.
champrep drive mv OLD NEWMover o renombrar un elementoDrive.
champrep drive rm REMOTE_PATHEliminar un archivo o una carpeta.
champrep drive mkdir REMOTE_PATHCrear una carpeta.
champrep drive quotaMostrar el espacio de almacenamiento utilizado y disponible.

Ejemplos:

Ventana de terminal
champrep drive ls /
champrep drive tree /projects
champrep drive cp ./report.pdf /reports/report.pdf
champrep drive cp /reports/report.pdf ./report.pdf
champrep drive quota --json
ComandoObjetivo
champrep mail lsMostrar los mensajes de una carpeta del buzón.
champrep mail read MESSAGE_IDImprimir un mensaje.
champrep mail sendEnvíe un mensaje. --subject es obligatorio; para enviarlo sin él, omítalo y pase --no-subject.
champrep mail accountsMostrar una lista de los buzones conectados.
champrep mail threadsMostrar los hilos de correo.
champrep mail domainsMostrar una lista de los dominios de correo visibles.

Utilizar champrep mail send --help antes de crear un script de envío, para que los indicadores de destinatario, asunto, cuerpo y archivos adjuntos de la versión instalada se gestionen correctamente.

ComandoObjetivo
champrep chat lsMostrar las salas.
champrep chat read ROOM_IDLeer los mensajes recientes.
champrep chat send ROOM_IDEnviar un mensaje a la sala.
champrep chat unreadMostrar el recuento de mensajes no leídos.
champrep chat createCrear una sala.
ComandoObjetivo
champrep contacts lsMostrar la lista de contactos.
champrep contacts search QUERYRealizar una búsqueda por correo electrónico o nombre.
champrep contacts read CONTACT_IDMostrar un contacto.
champrep contacts labelsMostrar una lista de etiquetas.
champrep contacts add USER_IDAñadir un usuario a los contactos.
champrep contacts update CONTACT_IDActualizar los metadatos de un contacto.
champrep contacts rm CONTACT_IDEliminar un contacto.

courses También admite el learn alias.

ComandoObjetivo
champrep courses lsMostrar los cursos disponibles.
champrep courses enrolledMostrar la lista de matrículas del usuario activo.
champrep courses read COURSE_IDMostrar un curso.
champrep courses sections COURSE_IDMostrar las secciones del curso.
ComandoObjetivo
champrep notes lsMostrar las notas recientes.
champrep notes createCrear una nota.
champrep notes read NOTE_IDImprimir una nota.
champrep notes edit NOTE_IDActualizar el título y/o el cuerpo de una nota.
champrep notes rm NOTE_IDMueva una nota a la Papelera. Restaure la nota en CHAMPREP Notes en un plazo de 30 días; transcurrido ese tiempo, se borrará automáticamente. Una nota en la Papelera se puede leer, pero no editar.
ComandoObjetivo
eve o champrep aiInicie el agente de programación en pareja con IA interactivo Eve en el directorio actual.
champrep eveAlias para champrep ai / eve.
eve -p PROMPT o champrep ai -p PROMPTEjecute el agente en modo sin interfaz gráfica para una sola consulta y muestre la respuesta.
champrep ai models lsMuestre los modelos de la plataforma y los modelos que haya registrado con su propia clave.
champrep ai models registerRegistre un modelo que utilice su propia claveAPI de proveedor.
champrep ai models rm NAMEElimine un modelo registrado y su clave.
champrep ai pathsMuestre todos los archivos y carpetas locales que utiliza el agente.
champrep ai chat [PROMPT]Plantee una pregunta puntual o inicie una sesión interactiva.
champrep ai summarizeResumir un archivo.
champrep ai conversationsMostrar las conversaciones guardadas.
champrep ai read CONVERSATION_IDLeer una conversación.
champrep ai rm CONVERSATION_IDEliminar una conversación.
champrep ai usageMostrar el uso actual de la IA.

Revisar los resultados importantes de la IA antes de basarse en ellos.

Para conocer los comandos con barra, los permisos y las opciones del agente, consulte Agente de IA: Eve (champrep ai / eve).

ComandoObjetivo
champrep meet createCrear una sala de reuniones.
champrep meet lsMostrar las reuniones.
champrep meet join MEETING_IDAbrir una reunión en el navegador predeterminado.

calendar También admite el cal alias.

ComandoObjetivo
champrep calendar todayMostrar los eventos de hoy.
champrep calendar weekMostrar los eventos de esta semana.
champrep calendar createCrear un evento.
champrep calendar rm EVENT_IDEliminar un evento.

Busque todo lo a lo que sus credenciales puedan acceder en una sola consulta. Los resultados se agrupan por servicio, y todo lo que se haya omitido se enumera indicando el motivo.

ComandoObjetivo
champrep search QUERYRealice una búsqueda en todos sus servicios.
champrep search servicesMuestre qué servicios puede consultar y si la búsqueda mediante IA está disponible.
OpciónObjetivo
-s, --serviceLimitar a un servicio (repetible). Mantiene la consulta económica.
--limitNúmero máximo de resultados por servicio (por defecto 5, máximo 20).
--aiClasifique los resultados con IA y obtenga una respuesta breve. Utiliza sus propios créditos de IA.
Ventana de terminal
champrep search "q3 roadmap"
champrep search "invoice 1042" --service invoice --service mail
champrep search "what did we decide about pricing" --ai

Una búsqueda cuesta una unidad de límite de tasa por cada servicio en el que se realice la búsqueda efectiva, por lo que restringir con --service es la forma más económica de mantener la respuesta ágil. --ai Consume sus créditos de IA mensuales; sin créditos, el comando sigue devolviendo resultados normales y le indica por qué no se ha ejecutado la clasificación mediante IA.

ComandoObjetivo
champrep work boardsMostrar sus tableros.
champrep work board BOARD_IDMostrar un tablero.
champrep work ticketsListar tickets. Filtrar por --board, --status (un ID de estado, o con --board un nombre de estado), --search, --mine; --limit 1 a 200.
champrep work ticket TICKETMostrar un ticket por ID o clave (por ejemplo ENG-7).
champrep work createCrear un ticket (--board, --title, --priority, --type).
Ventana de terminal
champrep work tickets --mine
champrep work create --board 642f... --title "Fix login" --priority high --type bug
ComandoObjetivo
champrep invoice lsMostrar una lista de facturas. Filtrar por --status.
champrep invoice read INVOICE_IDMostrar una factura.
champrep invoice issue INVOICE_IDEmitir un borrador (de borrador a emitido).
champrep invoice send INVOICE_IDEnviar una factura por correo electrónico (--to cuando no haya ningún destinatario registrado).
champrep invoice rm INVOICE_IDEliminar un borrador.

La emisión y el envío consumen el cupo de envío de facturas de su plan, por lo que requieren el invoice:send Ámbito de una claveAPI.

ComandoObjetivo
champrep forms lsMostrar sus formularios.
champrep forms read FORM_IDMostrar un formulario.
champrep forms responses FORM_IDMostrar las respuestas de un formulario.
champrep forms createCrear un formulario (--title, --description, --publish).
champrep forms publish FORM_IDPublicar un formulario borrador.
champrep forms rm FORM_IDMover un formulario a la papelera.

ComandoObjetivo
champrep charts meMostrar su puesto en el organigrama.
champrep charts treeImprima el organigrama en formato JSON.
champrep charts search QUERYBuscar personas en la organización.
champrep charts profile USER_IDImprimir el perfil de una persona en formato JSON.

Gestión de la organización (empresa). Las lecturas utilizan el business:read ámbito.

ComandoObjetivo
champrep business infoMostrar su organización y su función en ella.
champrep business membersMostrar los miembros de la organización.
champrep business usageMostrar las estadísticas de uso de la organización.

Proyectos, ramas, solicitudes de fusión, incidencias, pipelines, registros de trabajos y versiones. PROJECT es la ruta completa del proyecto (acme/web) o su ID. Referencia completa: CHAMPREP Comandos de código.

ComandoObjetivo
champrep code projects ls / show / createListar, mostrar y crear proyectos.
champrep code repo clone-url PROJECTImprimir la dirección de clonación (--ssh (para SSH).
champrep code cloneClone proyectos, un grupo (--group, --include-subgroups) o todo lo suyo (--membership, --owned, --all) en un árbol de espacios de nombres; --update lo mantiene actualizado.
champrep code branches ls PROJECTMostrar una lista de ramas.
champrep code mr ls / show / create / merge / approveWork con solicitudes de fusión.
champrep code issues ls / show / create / close / reopenWork con incidencias.
champrep code pipelines ls / show / run / retry / cancelWork con pipelines.
champrep code pipelines wait PROJECT [ID]Espere a que se ejecute una canalización, la más reciente de una confirmación (--sha), o la versión más reciente en --ref para finalizar; sale 0 Si se ejecuta correctamente, 1 De lo contrario, 8 en --timeout.
champrep code jobs ls / log / play / retryMostrar una lista de trabajos, imprimirlos o seguirlos (--follow) un registro, iniciar trabajos manuales.
champrep code releases ls PROJECTMostrar una lista de versiones.
champrep code runners ls / show / update / createMuestre una lista de ejecutores y de quién está en línea, modifique etiquetas, pause y reanude, cree un ejecutor.
champrep code ssh-keys lsEnumere sus claves SSH para utilizar Git a través de SSH.
Ventana de terminal
champrep code clone --group acme --include-subgroups --dest ~/src --ssh
champrep code mr ls acme/web
champrep code pipelines run acme/web --ref main --yes
champrep code jobs log acme/web 4182 --follow

Las recetas paso a paso para Code, Runner Farm y QA, incluido el uso de CI, se encuentran en Tareas habituales.

runner-farm También acepta el rf alias. --workspace selecciona la cuenta de la granja (personal, organization:<id>, team:<id>). Referencia completa: Comandos de Runner Farm.

ComandoObjetivo
champrep rf accounts ls / showMostrar una lista de las cuentas de la granja en las que puede actuar; mostrar una.
champrep rf connections lsMostrar una lista de las conexiones de los hosts de código.
champrep rf pools ls / show / create / updateGestionar grupos de ejecutores, incluidos --pause y --resume.
champrep rf usageCréditos y minutos para el periodo actual.
champrep rf jobs lsMostrar una lista de trabajos, incluidos los que están en espera y los retenidos.
Ventana de terminal
champrep rf pools ls
champrep rf usage

Repositorios, análisis, hallazgos, controles de calidad, vistas previas y espacios de trabajo IDE. REPO es una clave de repositorio, como code:<project-uuid>. Referencia completa: CHAMPREP QA comandos.

ComandoObjetivo
champrep qa repos ls / available / activate / deactivate / syncGestionar los análisis de control de calidad de los repositorios.
champrep qa scan REPOIniciar un análisis; --watch Lo sigue hasta el final.
champrep qa scans ls / showMostrar una lista de análisis y visualizarlos.
champrep qa findings ls / show / dismiss / reopenFiltro (--severity, --cwe, --branch, --state) y clasifica los hallazgos.
champrep qa gates status REPOMostrar el resultado de la puerta de calidad; salir 1 cuando se produce un error.
champrep qa previews ls / show / create / extend / stopGestione entornos de vista previa.
champrep qa ide ls / start / open / stopGestione los espacios de trabajo del IDE en la nube.
Ventana de terminal
champrep qa scan code:7d0c5c6e-0b6a-4e2b-9a55-0f8e6c1d2a10 --watch --yes
champrep qa findings ls --severity critical,high

En estas tres familias, los comandos que modifican algo o utilizan minutos de CI, créditos o asignaciones solicitan primero: code mr create, mr merge, mr approve, issues close y reopen, cada acción de pipeline y de trabajo, rf pools create y update, y cada qa escribir (repos activate y deactivate, scan, findings dismiss y reopen, previews create, extend y stop, ide start y stop). Pase --yes (-y) en scripts; sin terminal y sin --yes, no modifican nada. Al crear un proyecto o una incidencia en Code, no se le solicita. --workspace en rf y qa selecciona la cuenta que se utiliza y a la que se le cobra.

ComandoObjetivo
champrep accountMostrar su identidad, plan y uso actual de los límites de velocidad, el consumo diario y el almacenamiento.
Ventana de terminal
champrep account
champrep account --json

Gestionar el cpk_... Claves utilizadas para el acceso sin interfaz gráfica y de CI. Estos comandos requieren una sesión interactiva del navegador (ejecutar champrep auth login «first», no auth token). Al crear o rotar una clave, se muestra el secreto una sola vez.

ComandoObjetivo
champrep keys lsMostrar sus clavesAPI.
champrep keys createCrear una clave (--name, repetible --scope, --expires-in-days, --allowed-ip).
champrep keys get KEY_IDMostrar los detalles de una clave.
champrep keys audit KEY_IDMostrar el registro de auditoría reciente de una clave.
champrep keys update KEY_IDModificar el nombre, los ámbitos, la lista de direcciones IP permitidas o --active/--inactive.
champrep keys regenerate KEY_IDRotar el secreto (el secreto antiguo dejará de funcionar).
champrep keys revoke KEY_IDEliminar una clave.
Ventana de terminal
champrep keys create --name "CI deploy" --scope drive:read --scope drive:write
champrep keys create --name "read-only" --scope '*' --expires-in-days 90

Vista de solo lectura de su suscripción. Cambie de plan en el panel de facturación.

ComandoObjetivo
champrep billing subscriptionMostrar su suscripción actual (alias sub).
champrep billing cardsMostrar los métodos de pago guardados.
champrep billing receiptsMostrar los recibos anteriores.

Gestionar suscripciones a webhooks salientes. Utiliza el webhooks:manage ámbito.

ComandoObjetivo
champrep webhooks lsEnumere sus webhooks.
champrep webhooks eventsEnumere los tipos de eventos a los que puede suscribirse.
champrep webhooks createCree un webhook (--url, repetible --event). El secreto de firma se muestra una sola vez.
champrep webhooks rotate WEBHOOK_IDRote el secreto de firma.
champrep webhooks rm WEBHOOK_IDElimine un webhook.

Estos comandos no requieren una solicitud de servicio a menos que su texto de ayuda indique lo contrario.

ComandoObjetivo
champrep config get KEYLea un valor de configuración.
champrep config set KEY VALUEEstablezca un valor de configuración permitido. Un api_url o web_url debe ser un https:// ».
champrep config listImprima la configuración actual. Con --json Las claves son las propias del archivo (default_environment, api_url …).
champrep config pathMuestre la ruta del archivo de configuración.
champrep config env [NAME]Mostrar o establecer el entorno predeterminado.
champrep completion SHELLGenere autocompletado para Bash, Zsh, Fish o PowerShell.
champrep versionVersión de impresión, confirmación, fecha de compilación e información de tiempo de ejecución.

Los tokens no se almacenan en el archivo de configuración. No intente escribir un token de autenticación con config set.

CódigoSignificado
0Éxito.
1Error general o de uso, o un rechazo que no se soluciona al volver a iniciar sesión: no tiene acceso al elemento, no está incluido en su plan, se requiere pago o créditos, su rol, o una decisión que requiere su sesión web.
3Se requiere autenticación o esta no es válida.
4La credencial carece del ámbito requerido.
5Se ha alcanzado un límite de la pasarela en tiempo real.
6Fallo de red.
7Fallo de la pasarela o del servicio.
8Se ha agotado el tiempo de espera: code pipelines wait --timeout.

Los scripts deben comprobar el código de salida y analizar --json salida cuando esté disponible. No considere las frases de error legibles para el usuario como una interfaz estable.

Cada respuesta de la pasarela incluye sus límites actuales. La vuelve a intentar de forma transparenteCLI un límite breve por minuto, respetando Retry-After. Lo hace no no espera hasta alcanzar un límite diario ni ninguna espera superior a unos segundos; en su lugar, sale con un código 5 y notifica el tiempo de espera exacto, de modo que los scripts fallen rápidamente. Compruebe sus contadores en tiempo real en cualquier momento con champrep account.