Scripts

Com --json, stdout contém só JSON, indentado com dois espaços, enquanto as notas e o progresso ficam em stderr, e nada pede entrada. Uma lista mostra { items, hasMore, nextCursor }, um objeto da API é mostrado tal como a API o devolveu, e um comando escrito à mão mostra o objeto que a sua ajuda descreve.

openemail whoami --json | jq -r .workspaceIdopenemail emails list --status failed --json | jq -r ".items[].id"

Um erro vai para stderr como uma única linha de JSON, e o código de saída é o que uma pessoa receberia:

{"error":{"type":"permission_error","code":"insufficient_scope","message":"This API key does not have the domains:write scope.","hint":"The credential is missing a scope this call needs. Use a key that has it, or sign in again with openemail login.","next":null,"status":403,"requestId":"req_7Hc2kQ","param":null,"docUrl":"https://openemail.uk/docs/api/errors#insufficient_scope","exitCode":4}}

Parte da saída é um fluxo de objetos JSON, um por linha, para que um pipeline trate cada item assim que chega:

• —Uma lista de recursos com --all quando stdout não é um terminal, ou com --ndjson. --max <n> para depois desse número de itens.
• —openemail temp watch --json, uma linha por mensagem nova.
• —openemail mcp serve, uma mensagem JSON-RPC por linha em cada sentido.

openemail contacts list --all > contacts.ndjsonopenemail emails list --status failed --all --max 500 | jq -r .id

A CLI só pergunta quando stdin e stdout são ambos terminais, e não se aplica nenhum de --json, --no-input ou CI. Caso contrário:

• —Um valor obrigatório em falta para com o código de saída 2 e indica a opção a passar.
• —Um comando destrutivo para com Refusing to run unattended. Pass --yes to confirm. e o código de saída 2, a menos que passe --yes.
• —Uma alteração que precisa de um código de verificação para com o código de saída 4, porque ninguém o pode escrever. Use uma chave de API, ou execute primeiro openemail verify.

Dê ao trabalho uma chave de API só com os scopes de que precisa, guarde-a num segredo e deixe OPENEMAIL_API_KEY transportá-la. Nada é guardado, nada pede entrada e não corre nenhuma verificação de atualizações.

- name: Tell the team  env:    OPENEMAIL_API_KEY: ${{ secrets.OPENEMAIL_API_KEY }}  run: |    npx -y @openemail/[email protected] send \      --from [email protected] \      --to [email protected] \      --subject "Deployed ${{ github.sha }}" \      --text "Build ${{ github.run_number }} is live." \      --idempotency-key "deploy-${{ github.run_id }}"

ADDRESS=$(npx -y @openemail/[email protected] temp new --ttl 15)./signup-test.sh "$ADDRESS"npx -y @openemail/[email protected] temp watch --first --json | jq -r .snippetnpx -y @openemail/[email protected] temp delete --yes

failed=$(openemail emails list --status failed --json | jq ".items | length")test "$failed" -eq 0