Solução de problemas

Resolva erros comuns da CLI harumi: faça as verificações rápidas, veja se a plataforma está fora do ar, consulte erros frequentes e redefina o estado local.

Verificações rápidas

Confirme que você está logado

harumi whoami

Se isto falhar, rode harumi login (ou harumi login --signup para um e-mail totalmente novo).

Confirme que a pasta está vinculada

run, runs, check, skills add, datasources, schedules e secrets precisam de um projeto. Execute a partir de uma pasta que contenha .harumi/config.json (gravado por harumi new/import/clone/link) ou passe --project <PROJECT_ID>.

Verifique o status da plataforma

Se vários comandos falharem ao mesmo tempo, ou se um comando que funcionava começar a falhar com erros de conexão ou respostas HTTP 5xx, consulte status.harumi.io antes de depurar localmente. A página mostra uma verificação ao vivo de cada parte da plataforma:

Monitor	O que cobre
`Platform`	O aplicativo web da Harumi
`Harumi AI`	O Chat de IA da Harumi, incluindo a conexão com o banco de dados e com a API da Harumi
`API`	A API da Harumi usada pela CLI, incluindo seu banco de dados, cache, agendador e backend git
`Scheduling`	O agendador que dispara as execuções agendadas
`Git`	Repositórios de projetos (`import`, `clone`, `git push harumi`)
`MCP`	A conexão com o ChatGPT e o Claude
`Docs`	Este site de documentação
`Sandbox (ephemeral)`	Execução interativa de código
`Sandbox (scheduled)`	Execuções agendadas e em segundo plano
`Sandbox (apps)`	Aplicativos hospedados dos projetos
`Database`	O banco de dados da plataforma

Se algum monitor estiver fora do ar, aguarde a recuperação e tente de novo; não há nada a corrigir do seu lado.

Erros comuns

Sintoma	Causa provável	Solução
`Signups not allowed for otp` no `login`	Primeiro login deste e-mail	Tente novamente com `harumi login --signup`
`Provide --project or run from a directory with a .harumi binding`	Nenhum projeto resolvido	Entre em uma pasta vinculada ou passe `--project <id>`
`No Harumi project found in this directory (or any parent)` no `run`	Pasta não vinculada	`harumi new`/`harumi clone <PROJECT_ID>` para buscar um, ou `harumi link --project <PROJECT_ID>` se o código já está aqui
`Not a Harumi repo` / erros de remote git	O remote `harumi` não está configurado	Rode `harumi link --project <PROJECT_ID>` de novo; garanta que está numa pasta com `git init`
`No Gitea token found`	Token git não provisionado	Rode `harumi login` de novo
Non-fast-forward / "fetch first" / "unrelated histories" num `git push harumi ...` manual	Fazendo push normal contra um repositório que já tem um commit de scaffold	Rode `harumi clone <PROJECT_ID>` primeiro para ter o histórico do scaffold e faça o push a partir desse clone. Para criar um projeto novo a partir de uma pasta, use `harumi import` (faz force-push de propósito, veja Começando um projeto)
Rodou `harumi new <NOME> --no-clone`, mas não existe pasta nenhuma	`--no-clone` só cria o projeto — nunca toca no sistema de arquivos local	Rode `harumi clone <PROJECT_ID>` (o id que ele imprimiu) para buscar o código, ou omita `--no-clone` na próxima vez para criar e clonar em uma única etapa
`Run ended with status: failed` no `run --watch`	Seu código lançou erro ou saiu com código diferente de zero	`harumi runs get <RUN_ID>` para o stdout/stderr/erro capturado
`You belong to multiple organizations`	Organização não definida	`harumi org use <ORG_ID>` ou passe `--org` em cada comando
Um projeto novo não aparece no `projects list`, ou foi criado no workspace errado	Uma versão antiga da CLI ignorava a organização configurada ao criar projetos, então eles iam para o seu workspace pessoal	Atualize a CLI (`pipx upgrade harumi`), ou passe `--customer-id <ORG_ID>` explicitamente. Projetos já criados não mudam sozinhos — altere o workspace deles no app web
`Not a directory: <path>` no `import`	Apontou o `import` para um arquivo (ex.: um `.zip`) em vez de uma pasta	Aponte para um diretório descompactado, ou omita o caminho para enviar a pasta atual
`zsh: command not found: pip`	O Python do Homebrew só traz `pip3`, não `pip`	Use `pipx install harumi` (recomendado), ou `pip3 install harumi` / `python3 -m pip install harumi`
`error: externally-managed-environment` no `pip install`	A PEP 668 bloqueia o `pip` fora de um virtualenv	Use `pipx install harumi`, ou adicione `--user`, ou instale dentro de um venv

Reiniciando o estado local

Se sua sessão ou config ficarem em mau estado, são arquivos simples em ~/.harumi (ou $HARUMI_HOME, se definido):

harumi logout            # limpa sua sessão armazenada

O vínculo por projeto fica separado em <projeto>/.harumi/config.json; apague-o para desvincular uma pasta.