Saltar al contenido principal
La CometAPI CLI 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 administración de cuentas, todo desde la terminal. Empieza en 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 CometAPI CLI está en beta. Es normal encontrar pequeños cambios en los comandos y en 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 configuració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 token de acceso 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 en 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

Ve 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
/modelCambia el modelo activo
/systemEstablece o cambia el system prompt
/clearBorra el historial de la conversación
/historyMuestra el historial de la conversación
/saveGuarda la conversación en un archivo
/tokensMuestra el uso de tokens de la sesión
/helpLista todos los comandos del REPL
/exitSale del REPL

​
Integración con agentes

La CLI está diseñada para ser usada por agentes de codificación con 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 configuración), 77 (error de autenticación), 69 (servicio no disponible)
  • Los errores van a stderr y los datos van a stdout
  • Consulta la referencia completa de comandos para ver las opciones específicas de cada comando

​
Enlaces