Skip to main content

Reference

Plan support

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
warning

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.