NDL Nodal Context — open source

Business context and tests. Built together.

Build on your dbt project and query history. Let AI surface ambiguous business definitions, resolve them with your analyst, and turn each decision into shared context and evaluation cases. Free, Apache-2.0, and on your schedule.

Open source · Apache-2.0 · read the docs ↗

Watch · 1 minute 47 seconds

Meet Nodal Context.

A quick introduction to the open-source repo, from the user's perspective.

AI-generated explainer · 1:47

Watch on YouTube ↗

One source of truth

Keep your technical context. Add the business meaning.

Your analytics context builds on the sources you already maintain. Keep model logic, lineage, and column metadata in dbt. Give your agent access to that project and add the dashboard-level meaning it needs to answer real business questions.

  1. 01

    Discover ambiguity in the existing evidence

    Read the dbt project and authorized query history. Find recurring questions, competing definitions, and missing assumptions. Existing SQL is evidence to review, not automatically the right answer.

  2. 02

    Your analyst resolves the business meaning

    Does “active customer” mean a paying account or a product user? Which dashboard filters and time window apply? AI presents the ambiguity; your analyst confirms the interpretation. Reference the technical definitions where they already live.

  3. 03

    Build context and evaluations simultaneously

    Each confirmed decision becomes a business-context entry and a test case. Keep both in a reviewable repository your team owns, and share the maintained context with supported agents.

Test the difference

Did the context help? Measure it.

Compare answers with context off and on. Check live results against an analyst-approved reference when warehouse access is available. See what improved, what stayed the same, and what still needs work.

The local evaluation runner checks generated SQL requirements and entity choices with a model judge. It does not execute warehouse queries or grade numerical snapshots. Live answer verification is a separate guided workflow.

Read about evaluation ↗
Do it yourself · Free

Work at your own pace.

Use Claude Code, Codex, or Cursor with approved read-only data access and a domain expert. Your team maintains the references, runs comparisons, and reviews failures. The tools are Apache-2.0; model and warehouse usage are yours.

Get the repo ↗
Hands-on help · $5,000

Have us lead your first domain.

A scoped evaluation sprint with Nodal. Build context and tests, establish a baseline, and leave with a prioritized plan.

See the white-glove sprint →
Open source · Apache-2.0

Add Nodal Context to your agent and build your context today.

Select your agent

claude plugin marketplace add nodal-data/nodal-context
claude plugin install nodal-analytics@nodal

codex plugin marketplace add nodal-data/nodal-context
codex plugin add nodal-analytics@nodal

npx skills@latest add nodal-data/nodal-context

Then say “Take Nodal for a test drive on one analytics domain.” Start with five questions in one domain. Follow the quickstart ↗

Get the repo on GitHub