Utility Commands

whatalo whoami, logout, info, doctor, and upgrade — tools for managing your session and environment.

whatalo whoami

Show the currently authenticated developer and session details.

Syntax

whatalo whoami [options]

Options

Flag	Type	Description
`--portal-url <url>`	string	Developer Portal URL

Output

Field	Description
Email	Your developer account email
Company	Associated company name
Verified	Whether your account email is verified
Session remaining	Time left on the current access token (auto-refreshed if expired)

If your access token has expired but the refresh token is still valid, whatalo whoami refreshes it silently before displaying.

Example

whatalo whoami

whatalo logout

Sign out and revoke your session.

Syntax

whatalo logout [options]

Options

Flag	Type	Description
`--portal-url <url>`	string	Developer Portal URL

What it does

Sends a revocation request to the portal for the refresh token (best-effort, 5-second timeout — continues even if the request fails)
Deletes ~/.whatalo/session.json

Example

whatalo logout

whatalo info

Show project and environment information without making any API calls.

Syntax

whatalo info [options]

Options

Flag	Type	Description
`--json`	boolean	Output as JSON
`--portal-url <url>`	string	Developer Portal URL

Output sections

Project (reads from whatalo.app.toml and package.json)

Field	Source
Name	`whatalo.app.toml`
Slug	`whatalo.app.toml`
Plugin ID	`whatalo.app.toml`
Port	`whatalo.app.toml` dev config
Version	`package.json`

Environment (reads from the local system)

Field	Description
Node.js	Installed version
CLI	`@whatalo/cli` version
pnpm	Installed version
Vite	Version from `package.json`
TypeScript	Version from `package.json`
SDK	`@whatalo/plugin-sdk` version

Auth (reads from ~/.whatalo/session.json)

Field	Description
Email	Logged-in account
Session validity	Whether the session is active
Portal URL	Resolved portal URL

Example

whatalo info --json

whatalo doctor

Check your full development environment and report any issues.

Syntax

whatalo doctor [options]

Options

Flag	Type	Description
`--json`	boolean	Output as JSON
`--verbose`	boolean	Show detail for passing checks too
`--category <cat>`	string	Run only one category of checks
`--portal-url <url>`	string	Developer Portal URL

Check categories

Run a single category with --category <name>.

system — Local toolchain

Check	Requirement
Node.js version	>= 18
pnpm installed	Any version
git installed	Any version

auth — Session state

Check	What is verified
Session file exists	`~/.whatalo/session.json` present
Session valid	Access or refresh token is not expired

project — Plugin project

Check	What is verified
Config present	`whatalo.app.toml` found
Plugin linked	`plugin_id` set in config
SDK installed	`@whatalo/plugin-sdk` in `node_modules`
Dependencies installed	`node_modules` present

network — Connectivity

Check	What is verified
Portal reachable	HTTP GET to portal health endpoint
npm registry reachable	HTTP GET to `registry.npmjs.org`
cloudflared available	Binary present at `~/.whatalo/bin/cloudflared`

Total: 11 checks across 4 categories.

Exit codes

Code	Meaning
`0`	All checks passed
`1`	One or more checks failed

Example

whatalo doctor
whatalo doctor --category network
whatalo doctor --verbose --json

whatalo upgrade

Check for a newer version of @whatalo/cli and show the correct upgrade command.

Syntax

whatalo upgrade [options]

Options

Flag	Type	Description
`--json`	boolean	Output as JSON

What it does

Checks the npm registry for the latest version of @whatalo/cli
Compares it to the currently installed version
If a newer version is available, prints the correct upgrade command based on the detected package manager (pnpm, yarn, or npm)
No authentication required

Example output (update available)

  Current version:  1.2.0
  Latest version:   1.5.0

  Run to upgrade:
    pnpm add -g @whatalo/cli

Example

whatalo upgrade

whatalo login — Authenticate
whatalo info — See all configuration files

On this page