CLI setup
Install the npm beta, sign in to Postede through your browser, and verify access by listing your projects.
Prerequisites and installation
The Postede CLI requires Node.js 24 or later.
npm install -g @postede/cli
postede --versionFor a one-off command, try npx @postede/cli --help.
Connect and verify
The CLI connects to postede.com by default. For an approved test in another environment, add --env dev or --env local to each command.
postede auth login
postede auth status --json
postede projects list --jsonThe user completes browser sign-in and chooses permissions. Credentials stay in the OS keychain. Success requires status and project listing in the selected environment; an empty project list is valid. Setup performs no content or delivery writes.
Connection recovery
- Expired access: the CLI refreshes automatically. If refresh fails or consent is revoked, run
auth loginin the same environment with user approval. - Permission denied: check granted scope and project access; request only the missing access.
- Rate limit: wait for
retryAfterSeconds; do not loop or repeatedly reconnect.
Disconnect
postede auth logoutRevokes the refresh credential and removes local storage. --local-only removes storage without server revocation. A result with revoked: false does not prove revocation; report failures.
For immediate full-grant revocation, use Connected apps in the same environment. Never request passwords, cookies or tokens in conversation.