Cline: un agente de programación con varias interfaces
Leer el código de Cline: el parser temprano de --config
Reproduce ocho casos y entiende por qué la configuración precede a la telemetría.
Qué aprenderás
- Localizar la primera pasada
- Delimitar el ensayo local
- Aplicar el resultado al diagnóstico
Antes de empezar
- Conocimientos básicos de terminal y Git
- Repositorio desechable sin secretos
Analiza eventos sin ejecutar sugerencias y conserva resultados independientes de las declaraciones del agente.
Conclusiones clave
- La pasada elige la primera coincidencia.
- Ocho casos verifican solo el parser.
- Una ruta distinta puede ocultar credenciales guardadas.
Localizar la primera pasada
resolveConfigDirArg acepta --config seguido de un valor o --config=valor. Recorta espacios y devuelve la primera coincidencia. Nombres parecidos como --configure se ignoran.
La pasada precede a Commander porque algunos servicios leen configuración temprano. runCli aplica setClineDir antes de la telemetría; la acción de autenticación vuelve a aplicar su valor analizado.
Delimitar el ensayo local
La prueba extrae la función del main.ts fijado, elimina anotaciones TypeScript y la ejecuta en un contexto JavaScript aislado. Ocho casos cubren ausencia, variantes, espacios, vacíos, repetición y nombres parecidos.
Las ocho aserciones pasaron sin ejecutar runCli, escribir configuración, autenticar o llamar modelos. El resultado verifica argumentos, no permisos de almacenamiento ni aislamiento de seguridad.
Aplicar el resultado al diagnóstico
Si faltan credenciales, compara el directorio usado al autenticar con el de la tarea. Dos rutas distintas pueden mostrar ajustes diferentes sin que exista una caída del proveedor.
Evita repetir la opción y revisa comillas para rutas con espacios. Antes de borrar directorios identifica su contenido y conserva ajustes necesarios; eliminar configuración no es el primer paso de diagnóstico.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Compara las dos formas admitidas.
- 2
Verifica la misma ruta al autenticar y ejecutar.
- 3
Conserva ajustes antes de recuperar.
Ejemplo para copiar
{"argv":["--config=./trial-a","--config=./trial-b"],"earlyResult":"./trial-a","scope":"argument-parser-only"}Preguntas frecuentes
¿--config crea un sandbox?
El parser devuelve una ruta; no impone controles del sistema operativo.
¿Qué valor repetido se elige?
La primera coincidencia en la pasada temprana comprobada.
Fuentes
- Cline / apps/cli/src/main.tsFuente verificada 2026-09-23
- Cline / apps/cli/src/main.test.tsFuente verificada 2026-09-23