Status

agenta status is the command to run right after agenta login, and the one to reach for whenever something isn’t working: it tells you exactly what’s configured, what’s missing, and the next command to run.

agenta status

Alias: agenta whoami.

What it checks

Account: are you logged in, and as who (read from your session).
Organization and wallet: your org name and whether a payout wallet is activated.
Payment tools: whether agenta pay checkout will actually work right now.

Usage

agenta status [--json]

Flag	Description
`--json`	Output a single JSON object instead of the human-readable summary.

Example output

Output

  AgentaOS CLI
  ───────────────────────────────────
  Account:      demo@founder.dev
  Organization: Acme Freelance
  Wallet:       0x71C7...976F
  JWT expires:  2026-08-06 14:32 UTC (6h 40m remaining)
  Server:       https://api.agentaos.ai
  Config:       /Users/you/.agenta

  Payment tools:  ✓ Ready

  Next: agenta pay checkout -a 50 to create a checkout

If your wallet isn’t activated yet, Payment tools shows what’s blocking you instead of a green check, and Next points at agenta login to finish activation.

`--json`

{
  "account": {
    "authenticated": true,
    "email": "demo@founder.dev",
    "server": "https://api.agentaos.ai",
    "configDir": "/Users/you/.agenta",
    "jwtExpiresAt": "2026-08-06T14:32:00.000Z",
    "jwtSecondsRemaining": 24000,
    "organization": "Acme Freelance",
    "walletAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976",
    "walletActivated": true,
    "paymentTools": {
      "ready": true,
      "hint": "Run agenta pay checkout -a 50 to create a checkout."
    }
  }
}

--json also kicks in automatically whenever stdout isn’t a terminal, so piping to jq or writing to a file gives you JSON without the flag: agenta status | jq .account.walletActivated.

Response fields

Field	Description
`account.authenticated`	Whether you have a valid session.
`account.email`	Account email, decoded from your session token.
`account.organization`	Your organization’s name.
`account.walletAddress`	Payout wallet address, `null` if not activated.
`account.walletActivated`	Whether the wallet is ready to receive funds.
`account.paymentTools.ready`	Whether `agenta pay checkout` will succeed right now.
`account.paymentTools.hint`	What to do if it isn’t ready.
`account.jwtExpiresAt`	ISO 8601 timestamp your session token expires at.
`account.jwtSecondsRemaining`	Seconds left before that expiry.
`account.configDir`	Where the CLI stores its local session config.

Not logged in

{
  "account": {
    "authenticated": false,
    "reason": "not-logged-in",
    "hint": "Run agenta login to get started."
  }
}

reason is either not-logged-in or session-expired, so scripts can tell the two apart.

SDK

CLI

API Reference

What it checks

Usage

Example output

`--json`

Response fields

Not logged in

Next steps

Login

Pay

​What it checks

​Usage

​Example output

​--json

​Response fields

​Not logged in

​Next steps

Login

Pay

What it checks

Usage

Example output

`--json`

Response fields

Not logged in

Next steps