Workflow

A dbt project can be executed via the Command Line Interface (CLI). To use dbt, your workflow generally looks like:

  • Build your dbt project in a code editor: popular choices include VSCode and Atom.
  • Run your project from the command line:
    • macOS ships with a default Terminal program, however you can also use iTerm or the command line prompt within a code editor to execute dbt commands

Your command line has a concept of a "working directory": each command that you run is executed from a directory on your computer. To run your dbt project using the command line, you'll need to ensure that your command line's working directory is within your dbt project.

Use `pwd` to ensure that your terminal's working directory is your dbt project.
Use `pwd` to ensure that your terminal's working directory is your dbt project.

Once your working directory is your dbt project, you can execute dbt commands:

If you're using the CLI, we recommend learning some basics of your terminal to help you work more effectively. In particular, it's important to understand cd, ls and pwd to be able to navigate through the directory structure of your computer easily.

To install the CLI, check out our OS-specific guides in this section.

For a full list of dbt commands, see the dbt Command reference section.