La herramienta oficial de línea de comandos de Commet. Gestiona billing, reenvía webhooks y automatiza tu workflow desde la terminal.
Instalar
- pnpm
- npm
- yarn
Autenticación
commet login
Autentica vía navegador. Abre un flujo device-code y guarda tu token en ~/.commet/auth.json.
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.
--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.
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.
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.
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.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.
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.API Keys
Crea y gestiona API keys.Portal
Genera una URL de portal para el autoservicio del cliente.--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 devuelvenpayouts_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.commet test-clock advance
Avanza el test clock y procesa cada deadline de billing vencido antes de la fecha objetivo.
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
ConfiguraCOMMET_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.