run-sql

Execute SQL on the local development database. Auto-detects connection method from project context.

SQL Runner

• DB Engine: auto-detect (see Step 1)
• Schema File: .claude/natural-sql/schema.tsv (if exists)

Claim Conditions

I claim the query when:

• User explicitly mentions "local", "localhost", "docker", "my db", "dev db"
• User does NOT mention a remote environment (production, staging, etc.)
• No other runner has claimed the query (I am the default fallback)
• User mentions project-specific tables without specifying a remote environment — this means local

Key rule: If the user says "traeme los usuarios en telespine user" without mentioning prod/stg/dev, I claim it and run it against the local DB. I infer the connection from the project context (Docker, Django settings, etc.).

Step 1 — Determine Connection Method

Priority order: