planreview(1)

Move a plan to trash. Shared links return 410 Gone immediately, but the plan remains recoverable from planreview.dev until the purge deadline printed after deletion. This command never permanently deletes a plan.

Pass the HTML path you uploaded from and the CLI trashes the plan it remembers for that path. The CLI keeps that local record after trashing, so the plan stays recoverable. On another machine, or for a path this CLI never uploaded, target the plan directly with --plan. An unrecognised path exits with code 2 and tells you to provide --plan.

PATH

The path you uploaded the plan from; the file itself may already be gone. Cannot be combined with --plan.

--plan PLAN_ID

Target a plan explicitly instead of resolving it from a local path.

--api-url URL

Target a different API base URL for this run only.

--json

Emit planId, status, trashedAt, purgeAfter, and identitySource as one JSON line.

$ planreview delete ./plan.html
✓ moved to trash · Xk29fPq1…
→ shared links now return 410
→ restore it from planreview.dev before 2026-08-18T12:00:00.000Z

Show whether a token is available and verify it against the account endpoint. Reports the signed-in principal, where the token came from (environment or credentials), its scopes, and whether interactive HTML is enabled for the account.

--api-url URL

Check against a different API base URL for this run only.

--json

Emit the full status object as one JSON line.

$ planreview whoami
Logged in as prn_9fQ2mZk41RbXw7LcT0aHVw.
Token source: credentials
Interactive HTML: enabled
API: https://planreview.dev

Revoke the saved device ticket server-side, then remove saved credentials from the state directory. If revocation fails (for example, offline), credentials are still removed and the ticket can be revoked from the account page. A PLANREVIEW_TOKEN environment variable, if set, is untouched and remains active.

--json

Emit credentialsRemoved, environmentTokenActive and tokenRevoked.

$ planreview logout
→ revoking ticket tok_ztFzHrbJz5jlPifI_BkjtA … revoked
✓ saved credentials removed