Reference
DBT integration is available on Essential / Business plans and above.
CLI commands
Authentication
wren auth login
Prompts for Organization ID, API Key, and optional API endpoint. Credentials are stored in ~/.wrenai/wrenrc.yaml
.
wren auth status
Show current login status.
wren auth logout
Remove the saved credentials.
DBT import
Create a new Wren AI project from a dbt project:
wren dbt create
Update an existing linked project (referenced in .wrenconfig
):
wren dbt update --dbt-path /path/to/dbt-project
Skip confirmation:
wren dbt update --dbt-path /path/to/dbt-project --yes
Updating replaces the current MDL in your Wren AI project with those generated from your dbt models. Any manual changes made in Wren AI will be overwritten.
Configuration files
.wrenconfig
(project-level)
Created by wren dbt create
in the root of your dbt project. Used by wren dbt update
to locate and update the linked Wren AI project.
Typical contents:
# .wrenconfig
wren_project:
id: "783" # Wren AI Cloud Project ID
last_synced: "2025-10-09T10:28:07.006Z" # Last sync time
Notes:
- Commit this file to your dbt repository so collaborators can run
wren dbt update
.
wrenrc.yaml
(user-level)
Written to ~/.wrenai/wrenrc.yaml
after wren auth login
. Stores your local authentication and defaults.
Typical contents:
# ~/.wrenai/wrenrc.yaml
wren_profiles:
org_id: "5" # Your Organization ID
apikey: osk-xxx # Your API key
endpoint: https://cloud.getwren.ai/api/ # API endpoint
Notes:
- This file is user-specific; do not commit it.