La herramienta oficial de línea de comandos de Commet. Gestioná billing, reenviá webhooks y automatizá tu workflow desde la terminal.

Instalar

pnpm add -g commet

npm install -g commet

yarn global add commet

Requiere Node.js 18+.

Autenticación

commet login

Autenticá con Commet vía navegador usando un flujo device-code. Las credenciales se guardan en ~/.commet/auth.json.

commet login

En CI, configurá COMMET_API_KEY como variable de entorno — no necesitás login.

Prioridad	Fuente	Cómo configurar
1 (más alta)	Variable `COMMET_API_KEY`	`export COMMET_API_KEY=ck_...`
2	API key de proyecto	Auto-generada por `commet link` (guardada en `.commet/config.json`)
3 (más baja)	Credenciales guardadas	`commet login`

commet logout     # Eliminar credenciales almacenadas
commet orgs       # Listar organizaciones accesibles (nombre, slug, modo)

Configuración de proyecto

commet link

Vinculá este proyecto a una organización de Commet. Volvé a ejecutarlo para cambiar de organización.

commet link
commet link --org acme
commet link --clear

Flag	Requerido	Descripción
`--org <slug-o-id>`	No	Slug o ID de la organización — salta selección interactiva
`--clear`	No	Desvincular proyecto

commet pull

Descargá tu configuración de billing y generá commet.config.ts con features y planes tipados.

commet pull
commet pull --dry-run
commet pull --yes

Flag	Requerido	Descripción
`--dry-run`	No	Vista previa de cambios sin escribir archivos
`-y, --yes`	No	Saltar confirmación

Después de commet pull, tus llamadas al SDK tienen autocompletado para plan codes y feature codes.

commet push

Subí tu commet.config.ts local a Commet. Crea o actualiza features y planes para que coincidan con tu archivo.

commet push
commet push --dry-run
commet push --yes

Flag	Requerido	Descripción
`--dry-run`	No	Vista previa de cambios sin aplicar
`-y, --yes`	No	Saltar confirmación

commet create

Creá un nuevo proyecto de Commet desde un template.

commet create
commet create myapp -t fixed --org acme -y
commet create --list

Flag	Requerido	Descripción
`-t, --template <nombre>`	No	`fixed`, `seats`, `metered`, `credits`, `balance-ai`, `balance-fixed`
`--org <slug>`	No	Slug o ID de la organización
`--skills`	No	Instalar agent skills
`-y, --yes`	No	Aceptar defaults

Listen (reenvío de webhooks)

commet listen

Reenviá eventos de webhook desde Commet a tu servidor local. Sin necesidad de ngrok ni herramientas de tunneling externas.

commet listen 3000

El argumento acepta un puerto, host:port, o URL completa:

commet listen 3000                              # http://localhost:3000/
commet listen localhost:3000/webhooks            # http://localhost:3000/webhooks
commet listen http://local.commet.co:3010/api    # http://local.commet.co:3010/api

Filtrá por tipo de evento:

commet listen 3000 --events invoice.paid

Flag	Requerido	Descripción
`<url>`	Sí	Puerto, host:port, o URL completa
`--events <tipos>`	No	Tipos de evento separados por coma

  ✓ Authenticated (org: Acme Inc)
  ✓ Connected to Commet webhook stream
  ⟶ Forwarding to http://localhost:3000/
  ⟶ Signing secret: whsec_...

  Ready! Listening for webhook events...

  14:32:01  customer.created              →  200 OK     (12ms)
  14:32:05  subscription.updated          →  200 OK     (8ms)

La sesión queda abierta hasta Ctrl+C. Los eventos están firmados — usá el signing secret para verificar payloads igual que en producción.

Customers

Gestioná clientes de tu organización.

commet customers create

Creá un cliente.

commet customers create --email user@acme.com --id user_123
commet customers create --email team@acme.com --full-name "Acme Corp" --metadata '{"plan":"enterprise"}'

Flag	Requerido	Descripción
`--email <email>`	Sí	Email de facturación
`--id <id>`	No	ID de cliente personalizado
`--full-name <nombre>`	No	Nombre completo
`--domain <dominio>`	No	Dominio
`--website <url>`	No	URL del sitio web
`--timezone <tz>`	No	Timezone
`--language <lang>`	No	Código de idioma
`--industry <industria>`	No	Industria
`--address <json>`	No	Dirección (JSON: `{line1, city, postalCode, country}`)
`--metadata <json>`	No	Metadata arbitraria (JSON)

commet customers get --id cus_xxx                 # Obtener un cliente
commet customers update --id cus_xxx --email new@acme.com  # Actualizar un cliente
commet customers list --limit 25                  # Listar clientes
commet customers list --search "acme"             # Buscar por texto
commet customers list --cursor cus_xxx            # Paginación por cursor
commet customers list --start-date 2026-01-01 --end-date 2026-03-31  # Filtrar por fecha
commet customers create-batch --customers '[{"email":"a@co.com"},{"email":"b@co.com"}]'  # Crear en batch

Subscriptions

Gestioná suscripciones y sus operaciones.

commet subscriptions create

Creá una suscripción para un cliente. Esto genera un checkout session.

commet subscriptions create --customer-id user_123 --plan-code pro --billing-interval monthly
commet subscriptions create --customer-id user_123 --plan-id plan_xxx --skip-trial true
commet subscriptions create --customer-id user_123 --plan-code team --initial-seats '{"team_member":5}'

Flag	Requerido	Descripción
`--customer-id <id>`	Sí	ID del cliente
`--plan-code <code>`	Condicional	Código del plan (usá este o `--plan-id`)
`--plan-id <id>`	Condicional	ID del plan (usá este o `--plan-code`)
`--billing-interval <interval>`	No	`weekly`, `monthly`, `quarterly`, `yearly`, `one_time`
`--initial-seats <json>`	No	Mapa de asientos iniciales (JSON: `{featureCode: count}`)
`--skip-trial <bool>`	No	Saltar período de prueba
`--name <nombre>`	No	Nombre de la suscripción
`--start-date <date>`	No	Fecha de inicio (ISO 8601)
`--success-url <url>`	No	URL de redirección post-checkout

commet subscriptions cancel

Cancelá una suscripción. Por default cancela al final del período.

commet subscriptions cancel --id sub_xxx
commet subscriptions cancel --id sub_xxx --reason "Customer requested" --immediate true

Flag	Requerido	Descripción
`--id <id>`	Sí	ID de la suscripción
`--reason <razón>`	No	Motivo de cancelación
`--immediate <bool>`	No	Cancelar inmediatamente en vez de al final del período

commet subscriptions get-active --customer-id user_123           # Suscripción activa
commet subscriptions uncancel --id sub_xxx                       # Revertir cancelación pendiente
commet subscriptions change-plan --id sub_xxx --new-plan-id plan_xxx --new-billing-interval yearly  # Cambiar de plan
commet subscriptions list --customer-id user_123 --status active --limit 25 --cursor sub_xxx # Listar por cliente
commet subscriptions preview-change --id sub_xxx --plan-id plan_xxx --billing-interval yearly  # Preview de prorrateo
commet subscriptions activate-addon --id sub_xxx --addon-id addon_xxx  # Activar addon
commet subscriptions deactivate-addon --id sub_xxx --addon-id addon_xxx  # Desactivar addon
commet subscriptions adjust-balance --id sub_xxx --amount 1000 --type balance --reason "Courtesy credit"  # Ajustar balance
commet subscriptions topup-balance --id sub_xxx --amount 5000    # Top-up (cobra método de pago)
commet subscriptions purchase-credits --id sub_xxx --credit-pack-id cp_xxx  # Comprar créditos

Plans

Gestioná planes de billing.

commet plans create

Creá un plan.

commet plans create --name "Pro" --code pro --consumption-model metered --is-public true
commet plans create --name "Free" --code free --is-free true --is-public true
commet plans create --name "AI Pro" --code ai_pro --consumption-model balance --block-on-exhaustion true

Flag	Requerido	Descripción
`--name <nombre>`	Sí	Nombre del plan
`--code <code>`	Sí	Código único del plan
`--description <desc>`	No	Descripción
`--consumption-model <model>`	No	`metered`, `credits`, o `balance`
`--is-public <bool>`	No	Visible públicamente
`--is-free <bool>`	No	Plan gratuito
`--block-on-exhaustion <bool>`	No	Bloquear uso cuando se agota balance/créditos
`--plan-group-id <id>`	No	ID del grupo de planes
`--metadata <json>`	No	Metadata (JSON)

commet plans list --limit 25 --cursor plan_xxx     # Listar planes
commet plans list --include-private true           # Incluir planes privados
commet plans get --id pro                          # Obtener detalle
commet plans update --id plan_xxx --name "Pro Plus" --description "For growing teams" --metadata '{"tier":"mid"}' --is-public true  # Actualizar
commet plans delete --id plan_xxx                  # Eliminar
commet plans set-visibility --id plan_xxx --is-public false  # Cambiar visibilidad

Features de plan

commet plans add-feature

Agregá una feature a un plan con su configuración de uso y pricing.

commet plans add-feature --plan-id plan_xxx --feature-id feat_xxx --included-amount 1000 --overage-enabled true
commet plans add-feature --plan-id plan_xxx --feature-id feat_xxx --pricing-mode ai_model --margin 30
commet plans add-feature --plan-id plan_xxx --feature-id feat_xxx --unlimited true

Flag	Requerido	Descripción
`--plan-id <id>`	Sí	ID del plan
`--feature-id <id>`	Sí	ID de la feature
`--enabled <bool>`	No	Si la feature está habilitada
`--included-amount <n>`	No	Cantidad incluida de uso
`--unlimited <bool>`	No	Uso ilimitado
`--overage-enabled <bool>`	No	Habilitar cobro por excedente
`--overage-unit-price <n>`	No	Precio por unidad excedente (pricing `fixed`)
`--pricing-mode <mode>`	No	`fixed` o `ai_model`
`--margin <n>`	No	Porcentaje de margen (pricing `ai_model`)
`--credits-per-unit <n>`	No	Créditos por unidad

commet plans update-feature --plan-id plan_xxx --feature-id feat_xxx --included-amount 2000  # Actualizar
commet plans remove-feature --plan-id plan_xxx --feature-id feat_xxx  # Eliminar

Precios de plan

commet plans add-price

Agregá un precio a un plan.

commet plans add-price --plan-id plan_xxx --billing-interval monthly --price 2900 --trial-days 14
commet plans add-price --plan-id plan_xxx --billing-interval yearly --price 29000
commet plans add-price --plan-id plan_xxx --billing-interval monthly --price 4900 \
  --intro-offer-enabled true --intro-offer-discount-type percentage --intro-offer-discount-value 50 \
  --intro-offer-duration-cycles 3

Flag	Requerido	Descripción
`--plan-id <id>`	Sí	ID del plan
`--billing-interval <interval>`	Sí	`weekly`, `monthly`, `quarterly`, `yearly`, `one_time`
`--price <n>`	Sí	Precio en centavos
`--trial-days <n>`	No	Período de prueba en días
`--is-default <bool>`	No	Establecer como precio default
`--included-balance <n>`	No	Balance incluido
`--included-credits <n>`	No	Créditos incluidos
`--intro-offer-enabled <bool>`	No	Habilitar oferta introductoria
`--intro-offer-discount-type <type>`	No	`percentage` o `amount`
`--intro-offer-discount-value <n>`	No	Valor del descuento
`--intro-offer-duration-cycles <n>`	No	Duración en ciclos de facturación

commet plans update-price --plan-id plan_xxx --price-id price_xxx --price 3900  # Actualizar precio
commet plans delete-price --plan-id plan_xxx --price-id price_xxx  # Eliminar precio
commet plans set-default-price --plan-id plan_xxx --price-id price_xxx  # Establecer default

Precios regionales

commet plans set-regional-prices --plan-id plan_xxx --price-id price_xxx \
  --overrides '[{"currency":"EUR","price":2700},{"currency":"BRL","price":14900}]'
commet plans delete-regional-prices --plan-id plan_xxx --price-id price_xxx

Features

Gestioná el catálogo de features de la organización.

commet features create

Creá una feature.

commet features create --code api_calls --name "API Calls" --type usage --unit-name calls
commet features create --code analytics --name "Analytics" --type boolean
commet features create --code team_member --name "Team Members" --type seats

Flag	Requerido	Descripción
`--code <code>`	Sí	Código único de la feature
`--name <nombre>`	Sí	Nombre para mostrar
`--type <type>`	Sí	`boolean`, `usage`, o `seats`
`--description <desc>`	No	Descripción
`--unit-name <nombre>`	No	Nombre de la unidad (para features de tipo `usage`)

commet features list                                            # Listar el catálogo de features
commet features get --code api_calls                            # Obtener la definición de una feature
commet features update --code api_calls --name "API Requests" --description "HTTP API calls" --unit-name requests  # Actualizar
commet features delete --code api_calls                         # Eliminar

Feature Access

Consultá el acceso y uso de features de un cliente.

commet feature-access list --customer-id user_123                      # Listar acceso de un cliente
commet feature-access get --customer-id user_123 --code api_calls      # Detalle de acceso de una feature
commet feature-access can-use --customer-id user_123 --code api_calls  # Verificar si puede usar una unidad más

Seats

Gestioná asientos por feature para un cliente.

commet seats add

Agregá asientos a un cliente.

commet seats add --customer-id user_123 --feature-code team_member
commet seats add --customer-id user_123 --feature-code team_member --count 5

Flag	Requerido	Descripción
`--customer-id <id>`	Sí	ID del cliente
`--feature-code <code>`	Sí	Código de la feature
`--count <n>`	No	Cantidad de asientos. Default: `1`

commet seats remove --customer-id user_123 --feature-code team_member           # Quitar 1 asiento
commet seats remove --customer-id user_123 --feature-code team_member --count 3 # Quitar 3 asientos
commet seats set --customer-id user_123 --feature-code team_member --count 10   # Establecer cantidad exacta
commet seats set-all --customer-id user_123 --seats '{"team_member":5,"admin":2}'  # Establecer todos
commet seats get-balance --customer-id user_123 --feature-code team_member      # Balance de un tipo
commet seats get-all-balances --customer-id user_123                            # Todos los balances

Usage

Registrá y verificá eventos de consumo.

commet usage track

Registrá un evento de uso. Soporta tracking por valor y por tokens de modelos AI.

# Tracking por valor
commet usage track --feature api_calls --customer-id user_123 --value 1

# Tracking de tokens AI
commet usage track --feature gpt-4o --customer-id user_123 \
  --model gpt-4o --input-tokens 500 --output-tokens 150

# Con idempotency key
commet usage track --feature api_calls --customer-id user_123 --value 1 \
  --idempotency-key "req_abc123"

Flag	Requerido	Descripción
`--feature <code>`	Sí	Código de la feature
`--customer-id <id>`	Sí	ID del cliente
`--value <n>`	No	Valor de uso (tracking estándar)
`--model <modelo>`	No	Nombre del modelo AI (tracking por tokens)
`--input-tokens <n>`	No	Tokens de entrada (tracking por tokens)
`--output-tokens <n>`	No	Tokens de salida (tracking por tokens)
`--cache-read-tokens <n>`	No	Tokens de lectura de caché
`--cache-write-tokens <n>`	No	Tokens de escritura de caché
`--idempotency-key <key>`	No	Clave para deduplicación. Max 256 caracteres
`--timestamp <ts>`	No	Timestamp del evento (ISO 8601)
`--properties <json>`	No	Propiedades del evento (JSON)

Usá --value para tracking estándar o --model + --input-tokens + --output-tokens para tracking de tokens AI. Son mutuamente excluyentes.

commet usage check --customer-id user_123 --feature-code api_calls --quantity 1  # Verificar si el uso sería permitido

Addons

Gestioná extensiones de features comprables por suscripción.

commet addons create

Creá un addon.

commet addons create --name "Extra Storage" --base-price 500 --feature-id feat_xxx --consumption-model metered
commet addons create --name "Priority Support" --base-price 2000 --feature-id feat_xxx --consumption-model boolean

Flag	Requerido	Descripción
`--name <nombre>`	Sí	Nombre del addon
`--base-price <n>`	Sí	Precio base en centavos
`--feature-id <id>`	Sí	ID de la feature
`--consumption-model <model>`	Sí	`boolean`, `metered`, `credits`, o `balance`
`--description <desc>`	No	Descripción
`--included-units <n>`	No	Unidades incluidas (metered)
`--overage-rate <n>`	No	Tasa de excedente (metered/balance)
`--credit-cost <n>`	No	Costo en créditos (credits)

commet addons list --limit 25 --cursor addon_xxx  # Listar addons
commet addons get --id addon_xxx                  # Obtener detalle
commet addons update --id addon_xxx --name "Extra Storage Pro" --description "Premium storage" --base-price 800 --included-units 200 --overage-rate 5  # Actualizar
commet addons delete --id addon_xxx               # Eliminar
commet addons list-active --customer-id user_123  # Addons activos de un cliente

Credit Packs

Gestioná paquetes de créditos comprables.

commet credit-packs create --name "500 Credits" --credits 500 --price 4900
commet credit-packs list                          # Listar paquetes
commet credit-packs update --id cp_xxx --price 3900  # Actualizar
commet credit-packs delete --id cp_xxx            # Eliminar

Flag	Requerido	Descripción
`--name <nombre>`	Sí	Nombre del paquete
`--credits <n>`	Sí	Cantidad de créditos
`--price <n>`	Sí	Precio en centavos
`--description <desc>`	No	Descripción
`--is-active <bool>`	No	Si el paquete está activo

Plan Groups

Agrupá planes para mostrarlos juntos en pricing tables.

commet plan-groups create --name "Main Plans" --description "Primary pricing tiers" --is-public true  # Crear grupo
commet plan-groups list --limit 25 --cursor pg_xxx  # Listar grupos
commet plan-groups get --id pg_xxx                # Obtener detalle
commet plan-groups add-plan --id pg_xxx --plan-id plan_xxx --sort-order 1  # Agregar plan
commet plan-groups remove-plan --id pg_xxx --plan-id plan_xxx  # Quitar plan
commet plan-groups reorder-plans --id pg_xxx --plan-ids '["plan_a","plan_b","plan_c"]'  # Reordenar
commet plan-groups update --id pg_xxx --name "Updated Plans" --description "Revised pricing tiers" --is-public false  # Actualizar
commet plan-groups delete --id pg_xxx             # Eliminar

Invoices

Gestioná facturas.

commet invoices create-adjustment

Creá una factura de ajuste (monto negativo = crédito).

commet invoices create-adjustment --customer-id cus_xxx --amount -500 --description "Courtesy credit"
commet invoices create-adjustment --customer-id cus_xxx --amount 1000 --description "One-time charge"

Flag	Requerido	Descripción
`--customer-id <id>`	Sí	ID del cliente
`--amount <n>`	Sí	Monto en centavos (negativo para crédito)
`--description <desc>`	No	Descripción del ajuste
`--metadata <json>`	No	Metadata (JSON)

commet invoices list --customer-id cus_xxx --status paid --subscription-id sub_xxx --limit 25 --cursor inv_xxx  # Listar facturas
commet invoices get --id inv_xxx                  # Obtener detalle
commet invoices get-download-url --id inv_xxx     # URL de descarga del PDF
commet invoices send --id inv_xxx                 # Enviar por email
commet invoices update-status --id inv_xxx --status void  # Actualizar estado (paid, void)

Transactions

Gestioná transacciones de pago.

commet transactions list --status succeeded --customer-email user@acme.com --limit 20 --cursor txn_xxx  # Listar
commet transactions get --id txn_xxx              # Obtener detalle
commet transactions refund --id txn_xxx           # Reembolso completo
commet transactions retry --id txn_xxx            # Reintentar transacción fallida

Gestioná códigos de descuento.

commet promo-codes create

Creá un código promocional.

commet promo-codes create --code SUMMER25 --discount-type percentage --discount-value 25 \
  --duration-cycles 3 --max-redemptions 100
commet promo-codes create --code LAUNCH50 --discount-type amount --discount-value 5000 \
  --plan-ids '["plan_pro","plan_team"]'

Flag	Requerido	Descripción
`--code <code>`	Sí	Código promocional
`--discount-type <type>`	Sí	`percentage` o `amount`
`--discount-value <n>`	Sí	Valor del descuento
`--duration-cycles <n>`	No	Duración en ciclos de facturación
`--max-redemptions <n>`	No	Máximo de canjes
`--expires-at <date>`	No	Fecha de expiración (ISO 8601)
`--plan-ids <json>`	No	Restringir a planes específicos (JSON array)

commet promo-codes list --limit 25 --cursor promo_xxx  # Listar códigos
commet promo-codes get --id promo_xxx             # Obtener detalle
commet promo-codes update --id promo_xxx --active false --max-redemptions 50 --expires-at 2026-12-31 --plan-ids '["plan_pro"]'  # Actualizar

Webhooks

Gestioná endpoints de webhook.

commet webhooks create

Creá un endpoint de webhook.

commet webhooks create --url https://example.com/webhooks \
  --events '["subscription.activated","payment.received"]'

Flag	Requerido	Descripción
`--url <url>`	Sí	URL del endpoint
`--events <json>`	Sí	Eventos a suscribir (JSON array)
`--description <desc>`	No	Descripción

commet webhooks list --limit 25 --cursor wh_xxx   # Listar endpoints
commet webhooks delete --id wh_xxx                # Eliminar
commet webhooks test --id wh_xxx                  # Enviar evento de prueba

API Keys

commet api-keys create --name "Production" --expires-in-days 365  # Crear
commet api-keys list --limit 25 --cursor key_xxx  # Listar
commet api-keys delete --id key_xxx               # Eliminar

Portal

Generá una URL de portal para que un cliente gestione su suscripción.

commet portal get-url --customer-id user_123
commet portal get-url --email user@acme.com

Payouts

Gestioná cuentas bancarias de payout, solicitá payouts y completá la verificación de la cuenta.

commet payouts request

Solicitá un payout del balance disponible.

commet payouts request --amount 50000 --description "Weekly payout"

Flag	Requerido	Descripción
`--amount <n>`	Sí	Monto en centavos (USD, mínimo 1000)
`--description <desc>`	No	Descripción del payout

commet payouts add-bank-account

Agregá una cuenta bancaria de destino a la cuenta de payouts.

commet payouts add-bank-account \
  --account-number 000123456789 \
  --account-holder-name "Acme Inc." \
  --routing-number 110000000 \
  --account-type checking \
  --set-default true

Flag	Requerido	Descripción
`--account-number <number>`	Sí	Número de cuenta bancaria
`--account-holder-name <name>`	Sí	Nombre del titular
`--routing-number <number>`	No	Routing number
`--account-type <type>`	No	`checking` o `savings`
`--set-default <bool>`	No	Establecer como cuenta por defecto

commet payouts complete-verification

Aprovisioná la cuenta de payouts con el payload completo de KYC.

commet payouts complete-verification \
  --email owner@acme.com \
  --business-type company \
  --business-url https://acme.com \
  --document-url https://files.acme.com/incorporation.pdf \
  --bank '{"accountNumber":"000123456789","accountHolderName":"Acme Inc."}' \
  --company '{"name":"Acme Inc.","taxId":"12-3456789"}'

Flag	Requerido	Descripción
`--email <email>`	Sí	Email de contacto
`--business-type <type>`	Sí	`individual` o `company`
`--business-url <url>`	Sí	URL del sitio del negocio
`--document-url <url>`	Sí	URL del documento de identidad
`--bank <json>`	Sí	Cuenta bancaria como JSON: `{accountNumber, accountHolderName, ...}`
`--individual <json>`	No	Datos KYC del individuo (JSON, negocios individual)
`--company <json>`	No	Datos KYC de la empresa (JSON, negocios company)

Test Clock

Controlá 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

Mové el reloj hacia adelante.

commet test-clock advance --advance-days 30

commet test-clock advance --frozen-time 2026-07-01T00:00:00Z

Flag	Requerido	Descripción
`--advance-days <n>`	Uno de `advance-days` / `frozen-time`	Días para adelantar el reloj
`--frozen-time <ts>`	Uno de `advance-days` / `frozen-time`	Instante absoluto al que mover el reloj (ISO 8601)

commet test-clock get                # Estado actual del test clock
commet test-clock process-billing    # Correr los ciclos de facturación debidos al tiempo simulado

Quota

Gestioná allowances de quota para features basadas en quota.

commet quota add

Sumá al allowance de quota de un cliente para una feature.

commet quota add --feature-code api_calls --customer-id user_123 --count 100

Flag	Requerido	Descripción
`--feature-code <code>`	Sí	Código de la feature
`--customer-id <id>`	Uno de `customer-id` / `external-id`	ID del cliente
`--external-id <id>`	Uno de `customer-id` / `external-id`	ID externo del cliente
`--count <n>`	No	Cantidad a sumar. Default: `1`
`--idempotency-key <key>`	No	Clave para deduplicación

commet quota set --feature-code api_calls --customer-id user_123 --count 500    # Establecer allowance exacto
commet quota remove --feature-code api_calls --customer-id user_123 --count 10  # Restar del allowance
commet quota get --customer-id user_123 --feature-code api_calls                # Allowance de una feature
commet quota get-all --customer-id user_123                                     # Todos los allowances

Opciones globales

Estos flags funcionan en cualquier comando:

Flag	Descripción
`--output <formato>`	`human` (default) o `agent` (JSON)
`--help`	Mostrar ayuda de cualquier comando
`--version`	Mostrar versión del CLI

Comportamiento de salida

El CLI usa formato legible por default en terminales. Usá --output agent para JSON estructurado — ideal para agentes de IA, scripts y pipelines de CI.

commet customers list --output agent | jq '.[0].id'
commet plans list --output agent

CI/CD

Configurá COMMET_API_KEY como variable de entorno — no necesitás commet login:

# .github/workflows/billing.yml
env:
  COMMET_API_KEY: ${{ secrets.COMMET_API_KEY }}
steps:
  - run: |
      commet subscriptions create \
        --customer-id user_123 \
        --plan-code pro \
        --billing-interval monthly \
        --output agent

Archivos de configuración

Archivo	Creado por	Propósito
`~/.commet/auth.json`	`commet login`	Credenciales de autenticación global
`.commet/config.json`	`commet link`	Vínculo proyecto ↔ organización y API key auto-generada
`commet.config.ts`	`commet pull`	Config de billing generada con tipos

Ejecutá commet <comando> --help para la lista completa de flags en cualquier comando.