mako

Load when building, editing, or debugging Mako React apps — app files, npm dependencies, data bindings, the @mako/app-sdk hooks (useQuery / useDuckDB / useLocation / useSearchParams / navigate), URL state and shareable deep links, materialized Parquet/DuckDB bindings, and the live preview runtime.

Load for dbt branches, commits, pushes, pull requests, merges, repository sync, or branch cleanup.

Load when creating, editing, scheduling, running, or debugging dbt jobs and production deployments.

Load when building, editing, running, or debugging dbt models, dbt projects, schema.yml tests, sources, seeds, snapshots, incremental models, materializations, or dbt jobs in the Transforms section.

Load when creating, editing, configuring, validating, or debugging database sync flows, connector flows, pagination, incremental sync, destination mappings, and flow form fields.

Add a new MCP server preset (connector) to Mako's MCP client system — server URL, auth model (OAuth DCR, pre-registered app, or API key), scopes, icon, tests, and docs. Use when connecting a new external MCP server (like Slack or Close CRM) or changing how MCP connections authenticate.

Load when creating, modifying, debugging, or explaining Mako dashboards, dashboard widgets, data sources, local DuckDB SQL, Vega-Lite chart specs, layouts, and cross-filtering.

Load when the user shares a URL, asks to read a webpage or document, search the web for current information, or process online files (HTML, PDF, CSV, JSON).

Build, test, package, and release Mako Desktop and the Mako Local Agent. Use when changing packages/desktop, packages/local-agent, shipping a new desktop version, or debugging the desktop release pipeline.

Load when writing or debugging BigQuery SQL, including project.dataset.table names, backtick identifiers, date formatting, casts, regex functions, and BigQuery-specific query limits.

Load when writing or debugging ClickHouse SQL, including backtick identifiers, ClickHouse casts, date bucket functions, string matching, aggregate functions, and engine-specific limitations.

Load when writing or debugging MySQL SQL, including backtick identifiers, casts, date arithmetic, CONCAT, REGEXP, LIMIT/OFFSET, and MySQL-specific query syntax.

Load when writing or debugging PostgreSQL or Cloud SQL PostgreSQL SQL queries, including schema-qualified tables, date intervals, casts, JSON, arrays, pattern matching, and LIMIT syntax.

Load when writing or debugging SQLite or Cloudflare D1 SQL, including no-schema table names, dynamic typing, date/time functions, strftime, boolean values, UPSERT, and LIMIT syntax.

Load when writing or debugging MongoDB find or aggregate queries, especially table-friendly output, pivots, dotted keys, date bucketing, projections, limits, and aggregation pipelines.

Scaffold a new data source connector for the Mako sync system with backfill, CDC webhooks, tests, and deployment checks. Use when creating a new connector, adding a data source integration, or implementing a new sync provider.

Commit, push, and open a pull request for the current changes. Invoke explicitly with /pr.

Investigate React render performance in the Mako app using React Scan, render-debug logs, and existing memoization contracts. Use when profiling render churn, slow chat streaming, Monaco console responsiveness, explorer/result table lag, or when the user mentions React Scan.

Scaffold a new API route with proper auth, workspace scoping, and middleware chain for the Mako Hono backend. Use when adding new API endpoints.

Scaffold a new CDC (Change Data Capture) destination adapter for the Mako sync-cdc pipeline. Use when adding a new database target for CDC materialization (e.g., ClickHouse, MySQL, Snowflake).

Scaffold a new database driver for the Mako multi-database query execution system. Use when adding support for a new database type.

Scaffold a new Inngest function (event-driven, cron, or webhook-triggered) for the Mako workflow system. Use when creating background jobs, scheduled tasks, or event handlers.

Create a new MongoDB migration for schema or data changes in Mako. Use when adding fields, indexes, or modifying data in the database.