Referencia de comandos

Cada comando ofrece --help. Los análisis leen el directorio de compilación actual o --build-dir DIR (guardado para los siguientes comandos). Los comandos de proyecto usan el proyecto actual o --project DIR.

Diagnosticar y corregir

Comando	Función	Ejemplo
fix	Corrige una tarea fallida: aplica un parche a tu capa tras confirmar y repite la tarea; sin fallos aplica la propuesta de ask o explain	yocman fix
explain	Explica el último fallo sin cambios; guarda la corrección para yocman fix	yocman explain
ask	Responde preguntas sobre el proyecto; guarda cambios para yocman fix	yocman ask "how do I add a systemd service?"
context	Muestra versión, máquina, distribución y capas detectadas sin conexión	yocman context
login	Guarda la clave API y la verifica con el servicio	yocman login

Cuando ask o explain encuentra un cambio concreto en tus capas, se guarda para el directorio de compilación durante 14 días. Sin tareas fallidas, yocman fix aplica el diff sin otra llamada a la IA y verifica la tarea tras confirmar o con bitbake -e. yocman fix --list enumera propuestas, --proposal ID elige una, --discard ID la descarta y yocman fix RECIPE limita la selección. Las tareas fallidas tienen prioridad. fix, explain y ask admiten --dry-run: muestra los datos sin enviarlos.

Analizar la compilación

Comando	Función	Ejemplo
doctor	Enumera las fuentes del directorio de compilación y cómo activar las que faltan	yocman doctor
rules	Enumera reglas de análisis con identificador, categoría y gravedad	yocman rules --category size
conf	Comprueba local.conf, bblayers.conf, auto.conf y site.conf	yocman conf
layers check	Comprueba capas de bblayers.conf: ausentes, duplicadas, incompatibles, .bbappend huérfanos	yocman layers check
deps	Muestra las dependencias de compilación y ejecución de un paquete y quién depende de él	yocman deps openssl --reverse
why	Explica por qué un paquete está en la imagen: cadenas desde IMAGE_INSTALL	yocman why busybox
provides	Identifica el paquete que instala un archivo en la imagen	yocman provides /usr/bin/scp
unused	Enumera paquetes candidatos a eliminación para revisar	yocman unused
orphans	Recetas compiladas que no llegan a la imagen	yocman orphans
duplicates	Funciones duplicadas en la imagen, como dos servidores SSH	yocman duplicates
size	Tamaño por paquete, archivo y categoría; size diff compara compilaciones	yocman size diff ../build-old
buildtime	Tareas y recetas más lentas de buildstats y paralelismo efectivo	yocman buildtime
sstate	Reutilización de sstate y recetas reconstruidas en cada compilación	yocman sstate
boot	Tiempo de arranque con systemd-analyze blame y critical-chain	yocman boot --log blame.txt

Seguridad y conformidad

Comando	Función	Ejemplo
audit	Auditoría completa de seguridad y conformidad con puntuación por categoría	yocman audit --fail-on high
cve	CVE sin corregir de cve-check por CVSS; cve diff compara compilaciones	yocman cve diff old.json
secrets	Detecta claves, tokens y contraseñas en rootfs y capas, sin mostrarlos	yocman secrets
users	Comprueba cuentas: contraseñas vacías, UID 0 adicionales, hashes débiles, consolas de acceso	yocman users
perms	Comprueba permisos: setuid, escritura para todos, archivos sensibles, propietarios desconocidos	yocman perms
services	Comprueba servicios de arranque, servicios de red inseguros, ajustes SSH y depuración	yocman services
kernel-audit	Compara la .config del kernel con una lista de refuerzo	yocman kernel-audit
licenses	Comprueba licencias GPLv3, propietarias, ambiguas y obligaciones de código fuente	yocman licenses
sbom	Comprueba presencia del SBOM SPDX y coherencia con la imagen	yocman sbom
cra report	Preparación CRA: relaciona evidencias de CVE, secretos, SBOM, licencias y kernel con requisitos	yocman cra report --format md -o cra.md

Iniciar un proyecto

Comando	Función	Ejemplo
init	Crea un proyecto kas para placa y versión verificadas; --describe completa opciones con IA	yocman init --board rpi4-64 --release scarthgap
add	Añade funciones (SSH, Wi-Fi, Qt 6, Docker…) con diff para confirmar y commit	yocman add qt6
remove	Elimina una función si ninguna otra depende de ella	yocman remove wifi
build	Compila la imagen con progreso: fase, tareas activas y tiempo restante	yocman build
shell	Abre una consola con el entorno bitbake en host o contenedor	yocman shell
env	Comprueba el entorno, cambia entre host y contenedor y actualiza la imagen kas	yocman env use container
flash	Graba la imagen en SD o USB, solo discos extraíbles y con confirmación escrita	yocman flash --device /dev/sdb

Salida y CI

Los análisis admiten --format terminal|json|md, -o FILE, --fail-on LEVEL y --no-ai. Códigos: 0 correcto, 1 hallazgo de gravedad igual o superior a la elegida, 2 fuente ausente o error. --no-ai evita llamadas de red. env check comprueba entornos, env use cambia entre host y contenedor y env update-image propone la última imagen kas.