dbt Heros
Accelerate your dbt lifecycle with specialized Claude Code plugins. This repository provides high-performance agents and skills for mastering dbt Core, dbt Cloud, dbt Fusion, Elementary, and Lightdash.
Available Plugins
Core Principles
- Agentic Workflows: Move beyond static documentation into interactive, goal-oriented collaboration.
- Unified Interface: A single repository for all dbt ecosystem extensions.
- Safety First: Deterministic safety modes (
read-only, write-idempotent, write-destructive) for all tools.
Quickstart
1. Prerequisites
Ensure you have Claude Code installed and authenticated.
2. Configuration
Refer to the Product Documentation for detailed configuration instructions for each plugin.
Product Documentation
3. Installation
The most efficient way to use these plugins is by adding this repository as a plugin marketplace. This enables discovery and management of all specialized plugins through the /plugin interface.
Claude Code
Option A: Remote Marketplace (Recommended)
Add the repository as a marketplace to enable easy discovery and updates:
# Within Claude Code
/plugin marketplace add yu-iskw/dbt-heros
Once added, you can browse available plugins via /plugin discover or install them directly:
# Within Claude Code
/plugin install lightdash-analysis@dbt-heros
Option B: Direct Plugin Installation
You can also install specific plugins directly using their GitHub path:
# Within Claude Code
/plugin install yu-iskw/dbt-heros/plugins/lightdash-analysis
Option C: Local Installation (Development)
If you have cloned the repository locally, you can add it as a local marketplace or install individual plugins from local paths:
# Add as a local marketplace (at the repository root)
/plugin marketplace add .
# Or install an individual plugin
claude plugin install ./plugins/lightdash-analysis
Codex
Each plugin ships a .codex-plugin/plugin.json manifest. The repo-scoped marketplace catalog is at .agents/plugins/marketplace.json.
Option A: Repo-scoped Marketplace (Recommended)
When working inside this repository, Codex auto-detects .agents/plugins/marketplace.json and surfaces all five plugins in the plugin directory. No extra setup is needed. To enable a specific plugin:
# Within Codex
/plugin install lightdash-analysis@dbt-heroes
Codex caches installed plugins under ~/.codex/plugins/cache/dbt-heroes/<plugin-name>/local/. Each plugin can be enabled or disabled individually; state is stored in ~/.codex/config.toml.
Option B: Personal Marketplace (cross-repo access)
To make the plugins available from any repository, copy or symlink the marketplace file to the personal catalog location:
mkdir -p ~/.agents/plugins
# Copy
cp .agents/plugins/marketplace.json ~/.agents/plugins/marketplace.json
# Or symlink (stays in sync with repo updates)
ln -s "$(pwd)/.agents/plugins/marketplace.json" ~/.agents/plugins/marketplace.json
After restarting Codex, the dbt-heroes plugins will appear in the plugin directory regardless of the working directory.
Development
This repository is a monorepo. To add a new plugin or contribute to existing ones, refer to our Development Guide (coming soon).
