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 predeterminadosDocumentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
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:
config:
Ajustes disponibles
| Clave de configuración | Variable de entorno | Descripción |
|---|---|---|
api_key | COMETAPI_KEY | API key (obligatoria para todos los comandos) |
access_token | COMETAPI_ACCESS_TOKEN | Access token para comandos a nivel de cuenta |
base_url | COMETAPI_BASE_URL | URL base de la API (predeterminada: https://api.cometapi.com/v1) |
default_model | COMETAPI_DEFAULT_MODEL | Modelo predeterminado para chat (respaldo: gpt-5.4) |
output_format | — | Formato de salida predeterminado: table, json, yaml, csv o markdown |
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 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 confirmarse en el control de versiones. Agrega la ruta del archivo de configuración a tu
.gitignoresi corresponde.
Resolución de problemas
| Error | Solución |
|---|---|
API key not configured | Ejecuta cometapi init o configura la variable de entorno COMETAPI_KEY |
Connection failed | Ejecuta cometapi doctor para diagnosticar la conectividad |
Access token not configured | Solo se necesita para account/stats/tokens/logs/tasks. Ejecuta cometapi init para agregar uno |