Solución de problemas

Soluciones prácticas para los problemas con los que es más probable que te topes.

Fallos de autenticación

Si un comando devuelve un error de autenticación, confirma a qué identidad (si la hay) está resolviendo la CLI:

suya auth whoami     # calls the API and prints the resolved identity
suya auth status     # local auth status, no server call

Para agentes y CI, asegúrate de que SUBAYA_API_KEY esté exportada en el shell que ejecuta suya:

echo "${SUBAYA_API_KEY:?SUBAYA_API_KEY is not set}"

Recuerda la precedencia de credenciales: el indicador --token gana, luego SUBAYA_API_KEY, luego el token de OAuth almacenado localmente. Si iniciaste sesión hace mucho, un suya auth login reciente vuelve a establecer el token local. Consulta Autenticación y claves de API.

Los comandos llegan al host equivocado

Todo comando habla con https://subaya-dev.com por defecto. Si las solicitudes están fallando o aterrizando en un lugar inesperado, comprueba que no hayas pasado un --host extraviado:

suya auth whoami --host https://subaya-dev.com

Anula --host solo cuando tengas la intención de apuntar a un endpoint de API no predeterminado.

suya sim run no encuentra el testbench

La ruta --tb se interpreta dentro del árbol --source, no relativa al directorio de trabajo de tu shell. Si la ejecución informa de un testbench faltante, verifica que la ruta se resuelva dentro del directorio de código fuente que estás subiendo:

suya sim run --source . --tb tb/top_tb.sv --top top --tool ryusim

Dos cosas que comprobar:

• La ruta --tb existe bajo el directorio --source.
• El árbol --source es de 4 MB o menos: recorta los artefactos de compilación y los archivos binarios grandes antes de enviar.

Consulta CLI: sim para conocer la superficie completa de simulación.

suya repo connect / repo create falla

Ambos comandos repo requieren el id de instalación de la GitHub App vía --installation:

suya repo connect --installation <id> --owner <o> --repo <r>
suya repo create  --installation <id> --name <n>

Si todavía no tienes un id de instalación, instala primero la GitHub App; consulta Conecta un repositorio de GitHub. Confirma el estado de conexión actual con:

suya repo status

CLI desactualizada

Si falta un comando o un indicador, o el comportamiento no coincide con esta documentación, tu CLI puede estar desactualizada. Comprueba y actualiza:

suya version            # show version metadata
suya update --check     # report whether a newer release exists
suya update             # upgrade to the latest release

¿Sigues atascado?

• Vuelve a ejecutar con -v/--verbose para diagnósticos adicionales, o --json para salida legible por máquina.
• Comprueba el estado del servicio en la página de Estado.
• Explora la superficie de comandos completa en la Referencia de la CLI.