← The three ways to use DataTug with AI
Skills plugin
Give your coding agent DataTug skills.
The plugin teaches a coding agent how to use the datatug CLI. Add the marketplace once, install the plugin, then ask in plain words.
Skills plugin for coding agentsAvailable
Paste this into your AI agent:
Set up DataTug using https://datatug.ai/install-skills.md
Ask before changing shell settings or anything outside this setup.
Read the guide your agent gets The guide explains what your agent can set up and when it needs your approval. Setup needs no database passwords.
First, the CLI. The skills run it.
Every skill calls the datatug CLI, so it has to be installed and on your PATH before the skills can do anything.
Check that it is there:
datatug --helpInstall the plugin in Claude Code.
Run these two commands inside Claude Code. Nothing else to configure.
Add the marketplace
Once per machine. It tells Claude Code where DataTug's plugin lives.
/plugin marketplace add datatug/ai-marketplaceInstall the plugin
The DataTug skills are then available in any Claude Code session.
/plugin install datatug@datatugCheck that it works
Ask your agent:
List my DataTug projects.It uses the projects skill to list the DataTug projects registered on this machine. An empty list only means none are registered yet.
No CLI yet? Run /datatug:datatug-install in Claude Code. It shows how to install the CLI for your system and never runs the installer itself.
Which agents it works with.
Claude Code and DeepSeek Harness today. The others are not ready.
Claude CodeAvailable
Install it with the two commands above.
DeepSeek HarnessAvailable
Install the DataTug plugin bundle into DeepSeek Harness: a DataTug tab in the right sidebar and a `datatug` tool for the agent.
CodexPlanned
Listed in the marketplace's Codex catalog, but not tested in Codex yet. The plugin repository has a Codex manifest.
CursorPlanned
Not installable from this marketplace yet. The plugin repository has a manifest Cursor can read, which has not been tested in Cursor.
What your agent can do with it.
One skill for each part of the CLI the plugin covers. Each says whether it works today: the skills are only as ready as the CLI commands behind them.
/datatug:datatug-installAvailableShows how to install the datatug CLI when it is missing. It never runs the installer.
/datatug:datatug-initAvailableCreates a new DataTug project in a folder you choose.
/datatug:datatug-projectsAvailableLists the DataTug projects registered on this machine, and registers one you already have.
/datatug:datatug-scanAvailableReads a database's structure (tables, columns, keys) into a project, so the schema can be versioned.
/datatug:datatug-validateAvailableChecks that a project is well-formed, before you commit or in CI.
/datatug:datatug-serveAvailableStarts the local DataTug server that the web app connects to.
/datatug:datatug-datasetsIn developmentLists a project's datasets, shows a dataset's definition and prints its rows.
The CLI commands behind it cannot be told which project to use yet, so they stop with an error. Do not rely on it.
/datatug:datatug-queriesIn developmentLists and runs a project's saved queries.
datatug queriesnow lists a project's saved queries, but the skill's steps for running one name a subcommand that does not exist. Saved queries run today withdatatug query run, which no skill covers./datatug:datatug-query-builderPlannedBuilds a read-only query with you in conversation, while the query shows live in the DataTug web app.
It needs query-builder tabs and interactive editing tools. The local MCP server exposes schema discovery and saved SQL queries; it does not implement this UI contract. Depends on: AI assistant in the query builder.
