Solução de problemas

Correções práticas para os problemas que você tem mais chance de encontrar.

Falhas de autenticação

Se um comando retornar um erro de autenticação, confirme qual identidade (se houver) a CLI está resolvendo:

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

Para agentes e CI, certifique-se de que SUBAYA_API_KEY esteja exportada no shell que executa o suya:

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

Lembre-se da precedência de credenciais: a flag --token vence, depois SUBAYA_API_KEY, depois o token OAuth armazenado localmente. Se você fez login há muito tempo, um novo suya auth login restabelece o token local. Veja Autenticação & chaves de API.

Comandos atingem o host errado

Todo comando fala com https://subaya-dev.com por padrão. Se as requisições estiverem falhando ou caindo em algum lugar inesperado, verifique se você não passou um --host extraviado:

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

Só sobrescreva --host quando pretender mirar um endpoint de API não padrão.

suya sim run não encontra o testbench

O caminho de --tb é interpretado dentro da árvore de --source, não em relação ao diretório de trabalho do seu shell. Se a execução reportar um testbench ausente, verifique se o caminho resolve dentro do diretório de fonte que você está enviando:

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

Duas coisas a verificar:

• O caminho de --tb existe sob o diretório --source.
• A árvore de --source tem 4 MB ou menos — remova artefatos de build e arquivos binários grandes antes de enviar.

Veja CLI: sim para a superfície completa de simulação.

suya repo connect / repo create falha

Ambos os comandos repo exigem o id de instalação do GitHub App via --installation:

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

Se você ainda não tem um id de instalação, instale o GitHub App primeiro — veja Conectar um repositório GitHub. Confirme o estado atual da conexão com:

suya repo status

CLI desatualizada

Se um comando ou flag estiver ausente, ou o comportamento não corresponder a estes docs, sua CLI pode estar desatualizada. Verifique e atualize:

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

Ainda travado?

• Reexecute com -v/--verbose para diagnósticos adicionais, ou --json para saída legível por máquina.
• Verifique a saúde do serviço na página Status.
• Navegue pela superfície completa de comandos na Referência da CLI.