Skip to content

Environments

Set up a chat's cloud computer ahead of time, so new chats start with the code and tools ready.

A computer is the cloud machine a chat works on. An environment sets one up ahead of time: repositories cloned, tools installed, a setup script run. Every new chat in a project that uses it starts from that ready copy.

Manage environments in Settings › Computers.

Every chat has a computer even before you create an environment. Dexto default is the built-in one, with common developer tools such as Node, Python, git, the GitHub CLI and Chromium; Settings › Computers lists everything it includes. It is always ready, and a chat uses it whenever no environment applies.

  • up to twenty GitHub repositories, each with an optional branch or ref;
  • a setup script, such as pnpm install;
  • tools, each with one install line; and
  • a network policy: full access, or a list of allowed hosts.

An environment is either shared with your organization or private to you. Members your organization allows can edit shared environments; only you can see and edit a private one.

  1. The project’s environment, when the project picks one.
  2. Otherwise, the organization’s default environment.
  3. Otherwise, your own private environment.
  4. Otherwise, Dexto default.

An organization has at most one default. Choose Make default on a shared environment to set it.

When you create an environment or change it, Dexto builds it once, which takes a few minutes, and saves the result as a snapshot. New chats start from that snapshot with the code already there. Until the first snapshot is ready, new chats start from Dexto default and apply the environment as they start.

If a later build fails, chats keep using the last good snapshot. An environment shows Out of date when its snapshot was made from older settings or an older Dexto default; Dexto rebuilds environments in use when the platform changes and weekly for snapshots older than a week.

When an agent installs a system package in a chat that its environment lacks, the chat offers Add and rebuild to add it to the environment, or Only this chat to leave the environment as it is.