Repositories

Add repositories to your agent context to give it access to dbt repo, semantic layers (Cube, LookML, etc.), documentation, or anything else.

Why Add Repositories?

Adding repositories to your context allows your agent to:

Access dbt model definitions and documentation
Access your semantic layer repository
Reference internal documentation

Adding a Repository

When you run nao init, you can add a repository interactively:

nao init

Or add repositories in your nao_config.yaml:

repos:
  - name: dbt_project
    url: https://github.com/your-org/dbt-project

You can also use a local path instead of a Git URL:

repos:
  - name: dbt_project
    local_path: ../dbt

url and local_path are mutually exclusive. You must set exactly one. Optional file filters:

repos:
  - name: dbt_project
    local_path: ../dbt
    include:
      - "models/**/*.sql"
      - "models/**/*.yml"
    exclude:
      - "**/__pycache__/**"
      - "*.pyc"

Syncing only a subdirectory

If you only need a specific folder from a large repo (e.g. the models/ directory from a monorepo), use include patterns to scope the sync:

repos:
  - name: dbt_models
    url: https://github.com/your-org/monorepo
    include:
      - "dbt/models/**"

This clones the full repository but only indexes files matching the pattern. Combine multiple patterns to pull from several subdirectories:

repos:
  - name: data_platform
    url: https://github.com/your-org/data-platform
    include:
      - "dbt/models/**/*.sql"
      - "dbt/models/**/*.yml"
      - "docs/data-dictionary/**/*.md"
    exclude:
      - "**/test_*"

For local paths, you can also point local_path directly at the subdirectory instead of using filters:

repos:
  - name: dbt_models
    local_path: ../monorepo/dbt/models

Context Files

Synchronisation Sync your repositories to pull the latest content:

nao sync

This will:

Clone or copy the repository
Extract relevant files from the specified path
Index the content for the agent
Make it searchable

Context Output The output will be the synced repository content in the repos/ folder. After syncing, repositories are stored in:

context/
└── repos/
    └── dbt_project/

Get Started

Context Builder

Context Engineering

Chat Interface

Connectors

Self-Hosting

nao Cloud

nao Enterprise

Developers

Why Add Repositories?

Adding a Repository

Syncing only a subdirectory

Context Files

​Why Add Repositories?

​Adding a Repository

​Syncing only a subdirectory

​Context Files

Why Add Repositories?

Adding a Repository

Syncing only a subdirectory

Context Files