La CLI de CometAPI lee la configuración desde un archivo de configuración TOML, variables de entorno y flags de línea de comandos. Cuando la misma configuración está disponible desde varias fuentes, el orden de prioridad es:
Flags de CLI > archivo de configuración > variables de entorno > valores predeterminados
Archivo de configuración
Ubicación: ~/.config/cometapi/config.toml
Ejecuta el asistente de configuración para crear el archivo de configuración de forma interactiva:
O administra configuraciones individuales con el subcomando config:
Configuraciones disponibles
Credenciales
La CLI usa dos tipos de credenciales:
API key
Obligatoria para todos los comandos. La API key autentica las solicitudes a los endpoints de modelos de CometAPI.
Crea una API key en CometAPI Console → API Keys.
Configúrala de una de estas maneras:
Access token
Opcional. El access token es obligatorio para los comandos a nivel de cuenta: account, stats, tokens, logs y tasks.
Genera un access token en CometAPI Console → Personal Settings.
Configúralo de una de estas maneras:
Seguridad
La CLI aplica las siguientes prácticas de seguridad:
- Las API keys y los access tokens nunca se registran ni se muestran completos. Solo se muestran los últimos 4 caracteres en la salida de diagnóstico.
- El archivo de configuración se crea con permisos restrictivos (
0600) — solo puede leerlo el propietario del archivo.
- Las credenciales nunca deben enviarse al control de versiones. Agrega la ruta del archivo de configuración a tu
.gitignore si corresponde.
Eres responsable de todo el uso y los cargos generados con tus API keys. Mantén tus claves seguras y rótalas si sospechas de acceso no autorizado.
Solución de problemas