Dusk

Dusk is an open-source CLI that analyzes warehouse query history and turns it into:

• dusk-report.md: a human-readable map of how the organization actually queries data
• skills.md: portable agent context distilled from those same patterns

Status

This is the initial scaffold for the OSS CLI.

The current implementation is intentionally thin:

• CLI shape is in place
• scan pipeline shape is in place
• Snowflake is the first concrete adapter target
• Databricks and BigQuery are scaffolded but not implemented

Install

pip install -e .

Usage

dusk scan --warehouse snowflake --connection "$SNOWFLAKE_DSN"

You can also provide the connection via environment variable:

dusk scan --warehouse snowflake --connection-env SNOWFLAKE_DSN

Outputs

By default, Dusk writes:

• dusk-report.md
• skills.md

to the current working directory, or to --output-dir if provided.

Scope

Current scaffold covers:

• package metadata
• CLI entrypoint
• adapter interface
• scan orchestration
• markdown renderers
• normalized analysis models

It does not yet include:

• live warehouse querying
• SQL parsing / clustering logic
• tests
• full docs