Skip to main content
Smart Shell in Action Smart Shell in Action

​
Overview

Smart Shell provides an intelligent command-line interface that combines traditional terminal functionality with smart autocompletion. Execute dbt commands, Git operations, and standard Linux commands with intelligent assistance. The terminal knows about which files exist in your repository for enhanced suggestions.
Try asking questions in natural language and pressing Tab to get the right command suggestions for your needs.

​
Smart Autocompletion

The special feature of Smart Shell is its intelligent autocompletion. When you:
  1. Type a partial command and press Tab
  2. Ask a question and press Tab
  3. Need help with syntax and press Tab
The terminal will automatically suggest or complete the appropriate command for you.

​
Example Interactions

Question: “how do i verify if my dbt profiles set up right”Press Tab → Auto-completes to: dbt debugThis command checks your dbt configuration and profile setup.
Question: “dbt show dim suppliers”Press Tab → Auto-completes to: dbt show --select marts.core.dim_suppliersDisplays a sample of data from your dim_suppliers model with proper path resolution.
Question: “how do i test my data”Press Tab → Auto-completes to: dbt testRuns all tests defined in your dbt project.
Question: “show me commits from last week with file changes”Press Tab → Auto-completes to: git log --since="1 week ago" --stat --onelineDisplays commits from the last week with file change statistics in a compact format.

​
Supported Commands

  • dbt run - Execute models
  • dbt test - Run tests
  • dbt debug - Check configuration
  • dbt compile - Compile models
  • dbt docs generate - Generate documentation
  • And all other standard dbt commands
  • git status - Repository status
  • git add - Stage changes
  • git commit - Commit changes
  • git push - Push to remote
  • git pull - Pull from remote
  • And all other Git operations
  • ls - List directory contents
  • cd - Change directory (within project)
  • cat - Display file contents
  • grep - Search text
  • find - Find files
  • And other standard Linux utilities

​
Security Restrictions

For security and project integrity, certain commands are restricted:
Restricted: cd commands that navigate outside the dbt project directoryReason: Keeps you within your project workspace for security
Restricted: sudo commands and other privileged operationsReason: Prevents unauthorized system-level changes
Restricted: Commands that could damage the system or other projectsReason: Maintains environment stability and security

​
Quick Actions

For common dbt operations, you can simply click the Preview or Build buttons to preview or build the whole project directly without using command-line tools.

​
Next Steps

Quick Edit

AI-powered dbt assistant with full lineage context.

dbt Setup

Set up your dbt project to use with the AI Terminal.

Environment Variables

Configure environment variables for your dbt profiles.