Skip to content

Upgrading from 1.x

What changed in Dexto CLI 2.0, which commands moved or were removed, and how to update.

Dexto CLI 2.0 keeps the chat and dexto run you know, and adds sign-in, Dexto Cloud and your workspace in the terminal. Commands that talk to Dexto now share one output contract.

Terminal window
npm install -g dexto@latest

Your agents, chats and settings in ~/.dexto stay. For script installs, run dexto upgrade instead.

1.x2.0
dexto auth login, logout, statusdexto login, dexto logout, dexto whoami. See Sign in
Login minted an API keyLogin is a browser or device-code sign-in, saved per profile
dexto session list, history, deletedexto chat list, history, delete
dexto cloud sources, search, describedexto find
dexto deploy, dexto --cloud-agentGone. Use dexto cloud sites deploy and dexto cloud functions deploy
dexto trace, dexto spanGone for now. They return when /v1 serves run traces
dexto run --format json and jsonl--json and --stream-json; --text forces the reply
dexto run JSON with a version fieldNo version field; keys are snake_case; refusals are permission_denials

A saved 1.x API key (~/.dexto/auth.json) and dexto-cloud preview sign-ins carry over once, the first time you run 2.0. DEXTO_API_KEY and --api-key still work for CI.

  • dexto login, profiles, and dexto whoami.
  • dexto cloud: projects, agents, automations, files, sandboxes, secrets, Sites, Functions, models, search, fetch, data deletions, and a raw api call.
  • dexto workspace, publish, profile and skills push.
  • Dexto models in the harness, billed to your credits, and the Dexto MCP in every signed-in session.
  • JSON output, error objects with a fix, and exit codes 0 to 6. See Output and exit codes.
  • Notices (updates, startup banners) now go to stderr.

If a script reads dexto run --format json or jsonl, change the flag to --json or --stream-json. Keys are now snake_case, such as session_id and total_tokens, and the version field is gone. See dexto run for the result. An empty prompt now exits 2.