Saltar al contenido principal
La CLI de CometAPI es una herramienta oficial de línea de comandos para interactuar con la plataforma CometAPI. Admite chat multimodelo (streaming y REPL), búsqueda de modelos, consultas de saldo y uso, exploración de registros y gestión de cuentas, todo desde la terminal. Comienza desde la página del paquete en PyPI si quieres el comando de instalación más reciente, los metadatos del paquete y la versión de lanzamiento en un solo lugar.
La CLI de CometAPI está en beta. Espera pequeños cambios en los comandos y la UX mientras la interfaz de la CLI se estabiliza.

​
Características

  • Chat multimodelo con streaming y REPL interactivo
  • Búsqueda y listado de modelos
  • Saldo de la cuenta y estadísticas de uso
  • Exploración de registros de uso con filtros y exportación a CSV
  • Registros de tareas asíncronas (Suno, Midjourney, Kling y otros)
  • Salida en múltiples formatos: tabla, JSON, YAML, CSV, Markdown
  • Configuración basada en TOML con asistente de instalación
  • Autocompletado de shell para Bash, Zsh y Fish
  • Diseño compatible con agentes con salida JSON estructurada y códigos de salida deterministas

​
Requisitos previos

​
Instalación

Usa la página del paquete en PyPI como referencia principal de instalación y luego elige uno de los siguientes métodos para instalar la CLI: 
pip install cometapi-cli
Verifica la instalación: 
cometapi --version

​
Inicio rápido

1

Ejecuta el asistente de configuración

El asistente interactivo guarda tu API key y el access token opcional en un archivo de configuración local:
cometapi init
El asistente solicita:
2

Chatea con un modelo

Envía un solo mensaje con salida streaming:
cometapi chat "Explain quantum computing in one sentence"
Sobrescribe el modelo predeterminado:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

Busca modelos disponibles

Lista los modelos que coincidan con una palabra clave:
cometapi models --search gemini --limit 10
4

Consulta tu saldo

Visualiza el saldo de tu cuenta:
cometapi balance
Muestra la vista de facturación de la API key actual:
cometapi balance --source key
5

Ejecuta diagnósticos

Verifica que la CLI pueda conectarse a CometAPI:
cometapi doctor

​
Sesión de chat interactiva

Ejecuta cometapi chat sin argumentos para entrar en el REPL de chat de múltiples turnos: 
cometapi chat
Comandos del REPL:
CommandDescription
/modelCambiar el modelo activo
/systemEstablecer o cambiar el system prompt
/clearBorrar el historial de conversación
/historyMostrar el historial de conversación
/saveGuardar la conversación en un archivo
/tokensMostrar el uso de tokens de la sesión
/helpListar todos los comandos del REPL
/exitSalir del REPL

​
Integración con agentes

La CLI está diseñada para su uso por agentes de codificación de IA y scripts de automatización:
  • Todos los comandos de datos admiten --json para una salida estructurada y legible por máquinas
  • Códigos de salida deterministas: 0 (éxito), 64 (falta la configuración), 77 (error de autenticación), 69 (servicio no disponible)
  • Los errores van a stderr, los datos van a stdout
  • Consulta la referencia completa de comandos para ver las opciones de cada comando

​
Enlaces