Saltar al contenido principal
La herramienta oficial de línea de comandos de Commet. Gestiona billing, reenvía webhooks y automatiza tu workflow desde la terminal.

Instalar

Requiere Node.js 18+.

Autenticación

commet login Autentica vía navegador. Abre un flujo device-code y guarda tu token en ~/.commet/auth.json.
En CI, configura COMMET_API_KEY como variable de entorno en su lugar. El CLI usa dos tipos de credenciales, según el comando: Los comandos de recursos nunca caen en las credenciales de commet login — sin una API key del entorno o de un proyecto vinculado, fallan y te indican correr commet link.

Setup

commet agents setup Prepara un repositorio existente para agentes de código. El comando preserva el resto de AGENTS.md y administra únicamente su propio bloque delimitado, por lo que puedes volver a ejecutarlo o quitarlo más adelante.
Usa --check --output agent en workflows automatizados para verificar que las instrucciones administradas estén al día sin reescribir el archivo. commet doctor Revisa el SDK instalado, la configuración del proyecto, las instrucciones del agente y el entorno local antes de pedirle que implemente billing. Doctor es de solo lectura: no se conecta con Commet, no modifica archivos y no imprime secretos.
El output para agentes es compacto y sirve como contexto para una tarea de implementación. Para la guía del SDK que coincide con la versión instalada, empieza por node_modules/@commet/node/docs/README.md. commet link Vincula este proyecto a una organización de Commet. Vuelve a ejecutarlo para cambiar de organización.
commet pull Descarga tu configuración de billing y genera commet.config.ts con features y planes tipados.
Después de commet pull, tus llamadas al SDK tienen autocompletado para plan codes y feature codes. commet push Sube tu commet.config.ts local a Commet. Crea o actualiza features y planes para que coincidan con tu config. Un plan cuyos precios, features o reglas de créditos y balance cambian recibe una nueva versión actual. Los compradores nuevos la reciben; las suscripciones existentes se quedan en su versión hasta que las muevas desde la API o MCP, con Change subscription version o Move subscribers to a plan version.
Los cambios de tipo de feature (boolean a usage, etc.) están bloqueados vía push. Cámbialos desde el dashboard.
commet create Crea un nuevo proyecto de Commet desde un template. Crea planes y features en tu organización sandbox, genera una API key y vincula el proyecto.
commet listen Reenvía eventos de webhook desde Commet a tu servidor local. Sin necesidad de ngrok ni herramientas de tunneling externas.
El argumento acepta un puerto, host:port, o URL completa:
Filtra por tipo de evento:
La sesión queda abierta hasta Ctrl+C. Los eventos están firmados con el secret mostrado.

Customers

Crea y gestiona clientes, consulta detalles y maneja operaciones en batch. commet customers create Crea un cliente.

Subscriptions

Crea, cancela y gestiona suscripciones. Cambia planes, activa addons y maneja operaciones de balance. commet subscriptions create Crea una suscripción para un cliente.
commet subscriptions cancel Cancela una suscripción. Por default cancela al final del período.

Plans

Crea planes, adjunta features y precios, y configura precios regionales. Los comandos que cambian los precios, las features o las reglas de créditos y balance de un plan publican una nueva versión actual del plan. Los compradores nuevos la reciben; las suscripciones existentes se quedan en su versión hasta que las muevas desde la API o MCP, con Change subscription version o Move subscribers to a plan version. commet plans create Crea un plan.
commet plans add-feature Agrega una feature a un plan con pricing y límites.
commet plans add-price Agrega un precio a un plan.
Crea una variante seleccionable que sólo cambie Argentina y herede el resto del precio base:

Precios regionales

Define overrides en moneda local para un precio.

Features

Gestiona el catálogo de features de la organización. commet features create Crea una feature.

Feature Access

Consulta el acceso y uso de features de un cliente.
Usa commet usage check --customer-id user_123 --feature-code api_calls --quantity 1 para evaluar un consumo futuro.

Seats

Gestiona asignaciones de asientos para billing por asiento. commet seats add Agrega asientos a un cliente.

Usage

Registra eventos de consumo y verifica el margen disponible. commet usage track Registra un evento de uso. Soporta tracking por valor y por tokens de modelos AI.

Addons

Crea y gestiona extensiones de features comprables. commet addons create Crea un addon.

Credit Packs

Crea y gestiona paquetes de créditos para planes basados en créditos.

Plan Groups

Organiza planes en grupos para pricing tables y el portal del cliente.

Invoices

Lista recibos, descarga PDFs y crea ajustes. commet invoices create-adjustment Crea un recibo de ajuste. Usa un monto negativo para créditos.

Payments

Crea payment links alojados y cobra métodos de pago guardados. Pagos únicos, sin suscripción ni plan. Mira Aceptar pagos únicos para el ciclo completo. commet payments create Crea un payment link alojado. El cliente abre la url devuelta y paga con cualquier tarjeta.

Transactions

Lista transacciones, procesa reembolsos y reintenta pagos fallidos.

Offers

Crea Offers reutilizables de forma independiente de los planes y canales de distribución.
percentage usa basis points, por lo que 2500 significa 25%. Los otros tipos de fase son amount_off y fixed_price. Las pruebas se configuran en el precio del plan con --trial-days.
Una Offer no contiene purpose ni asociaciones con precios. Vincula una Offer compatible a un precio base desde el Dashboard para selección introductoria automática, envía su ID directamente como offerId o referénciala desde un Promo Code.

Promo Codes

Crea y gestiona códigos de distribución que el customer ingresa en checkout. commet promo-codes create Crea un código promocional.

Markets

Define grupos de países reutilizables y referéncialos desde --market-prices al crear o actualizar precios.

Webhooks

Crea y prueba endpoints de webhook. commet webhooks create Crea un endpoint de webhook.
Para desarrollo local, usa commet listen en lugar de crear un endpoint de webhook.

Provisioning

Emite un claim link nuevo para una organización aprovisionada de forma headless que todavía no fue reclamada. El comando usa la API key de esa organización; no puede emitir un link después de que una persona la reclama.
Usa la misma idempotency key al reintentar el mismo request. Entrégale la URL devuelta al owner humano previsto; no la publiques ni la guardes en source control.

API Keys

Crea y gestiona API keys.

Portal

Genera una URL de portal para el autoservicio del cliente.
Pasa --customer-id o --email, uno de los dos.

Payouts

Gestiona cuentas bancarias de payout y solicita payouts. Los comandos de payouts requieren una API key de una organización live; las keys de sandbox devuelven payouts_not_available_in_sandbox. commet payouts request Solicita un payout del balance disponible.
commet payouts add-bank-account Agrega una cuenta bancaria de destino a la cuenta de payouts.

Test Clock

Controla el reloj de prueba de sandbox para simular el paso del tiempo.
Solo sandbox. Los comandos de test clock fallan contra organizaciones live.
commet test-clock advance Avanza el test clock y procesa cada deadline de billing vencido antes de la fecha objetivo.
El comando anterior commet test-clock process-billing está deprecado. advance ahora inicia automáticamente el procesamiento de billing.

Quota

Gestiona allowances de quota para features basadas en quota. commet quota add Suma al allowance de quota de un cliente para una feature.

Opciones globales

Estos flags funcionan en cualquier comando: Usa --output agent para salida JSON estructurada en scripts y pipelines de CI:

CI/CD

Configura COMMET_API_KEY como variable de entorno. No necesitas commet login.
.github/workflows/billing.yml
.github/workflows/subscription.yml

Archivos de configuración

Ejecuta commet <comando> --help para la lista completa de flags y opciones en cualquier comando.