Skip to main content
Choose the way you want to use Dex. The skills guide an agent through the same engine that the CLI exposes directly.

​
Prerequisite

Install uv version 0.13.4 or later and check that your terminal can find it:
Dex’s skill wrappers use uv to install and run the engine. Your agent needs a local shell and access to your project directory.

​
Choose one installation path

Run this in your terminal and choose your agent when prompted:
For Codex, you can select the agent explicitly:
Open your project in the agent and ask it to use Dex. The three skills are explore, transform, and maintain.

​
Start from the project directory

Open the directory containing your project. Dex discovers .dex/config.yml up the directory tree, and uses the dbt project and semantic definitions in that repository. Try this prompt after connecting your data:
The skill wrapper downloads the engine and connector dependencies on its first run. Ask your agent to warm the installed wrapper with --warm if you want to pay that setup cost ahead of an interactive session. Warm-up installs packages; it does not query the warehouse.
Point it at the repository’s AGENTS.md. It contains the engine procedure and command contract.With the CLI installed, dex procedure --block also prints the current procedure for inclusion in an agent’s instructions. See dex procedure for checking that a copied procedure is current.
Continue with the local quickstart, or connect an existing warehouse.