Скрипты

С --json stdout содержит только JSON с отступом в два пробела, заметки и прогресс остаются в stderr, и ничего не спрашивается. Список выводит { items, hasMore, nextCursor }, объект API выводится так, как его вернул API, а написанная вручную команда выводит объект, описанный в её справке.

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

Ошибка уходит в stderr одной строкой JSON, а код выхода тот же, что получил бы человек:

{"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}}

Часть вывода это поток JSON-объектов, по одному в строке, чтобы конвейер обрабатывал каждый элемент по мере поступления:

• —Список ресурсов с --all, когда stdout не терминал, или с --ndjson. --max <n> останавливается после стольких элементов.
• —openemail temp watch --json, по одной строке на новое письмо.
• —openemail mcp serve, по одному сообщению JSON-RPC в строке в каждую сторону.

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

CLI задаёт вопросы, только когда stdin и stdout оба терминалы и не действует ни --json, ни --no-input, ни CI. Иначе:

• —Отсутствующее обязательное значение завершается с кодом выхода 2 и называет флаг, который нужно передать.
• —Разрушительная команда завершается с Refusing to run unattended. Pass --yes to confirm. и кодом выхода 2, если вы не передадите --yes.
• —Изменение, которому нужен код подтверждения, завершается с кодом выхода 4, потому что ввести его некому. Используйте API-ключ или сначала запустите openemail verify.

Дайте задаче API-ключ только с нужными scope, храните его в секрете и пусть его передаёт OPENEMAIL_API_KEY. Ничего не сохраняется, ничего не спрашивается, и проверка обновлений не запускается.

- 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