Skip to documentation

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.

Install from npm
npm install -g @postede/cli
postede --version

For 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.

Read-only verification
postede auth login
postede auth status --json
postede projects list --json

The 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 login in 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.
Exit codes and exact retry rules ↗

Disconnect

Terminal
postede auth logout

Revokes 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.

V-2026-11-19_20.25.44