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.
Upgrade
Section titled “Upgrade”npm install -g dexto@latestYour agents, chats and settings in ~/.dexto stay. For script installs, run dexto upgrade instead.
What changed
Section titled “What changed”| 1.x | 2.0 |
|---|---|
dexto auth login, logout, status | dexto login, dexto logout, dexto whoami. See Sign in |
| Login minted an API key | Login is a browser or device-code sign-in, saved per profile |
dexto session list, history, delete | dexto chat list, history, delete |
dexto cloud sources, search, describe | dexto find |
dexto deploy, dexto --cloud-agent | Gone. Use dexto cloud sites deploy and dexto cloud functions deploy |
dexto trace, dexto span | Gone 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 field | No version field; keys are snake_case; refusals are permission_denials |
What carries over
Section titled “What carries over”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.
What is new
Section titled “What is new”dexto login, profiles, anddexto whoami.dexto cloud: projects, agents, automations, files, sandboxes, secrets, Sites, Functions, models, search, fetch, data deletions, and a rawapicall.dexto workspace,publish,profileandskills 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.
Scripts that used 1.x JSON
Section titled “Scripts that used 1.x JSON”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.