Terminal
Terminal/Skill
Runs MotherDuck queries and logins from a terminal, and edits Dives (React and SQL apps) and Flights (Python jobs) as local files.
By MotherDuck
Works with
npx skills add motherduckdb/agent-skills --skill motherduck-climotherduck dive guide or motherduck flight guide. Those built-in guides are the current runtime contract.motherduck <command> --help after a parsing or option error instead of guessing at syntax.motherduck status before starting a login flow.MOTHERDUCK_TOKEN through the environment and set an absolute, task-specific MOTHERDUCK_HOME so parallel agents do not share credentials or assets.--output json for machine-readable resource operations and check both the exit code and returned success field. motherduck query --output json returns a bare JSON array instead.motherduck new merely because authentication is missing. Account creation requires an explicit signup request.dive push, flight push, scheduling, secret changes, and account creation as external mutations. Perform them only when the user's build/change request includes that outcome.motherduck query with the smallest suitable output format.For answer, review, or planning requests, recommend commands without logging in, creating an account, or changing remote resources. For explicit build/change requests, complete the in-scope CLI workflow and validate its result; ask before destructive deletes or materially broader external changes.
Read only the reference sections needed for the current task.
references/CLI_PLAYBOOK.md for installation, authentication, JSON contracts, query patterns, agent isolation, and complete Dive/Flight file workflows.Load related skills only for missing capabilities; reuse established context.
motherduck-connect for choosing the underlying application connection pathmotherduck-explore and motherduck-query for catalog discovery and SQL behaviormotherduck-create-dive and motherduck-create-flight for the product-specific authoring workflow