datatug
DataTug CLI plugin: skills that teach AI agents how to use the datatug CLI for data exploration, dataset management, schema scanning, and query execution.
Not in a marketplace yet, so it loads for one session with --plugin-dir.
Plugin datatug in datatug/ai-plugin. Commands read from the repo's manifest — 2 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.
What it installs
Skills (15)
datatug-agent-accessRead protected DataTug data as your registered agent (`datatug db get` / `db preview --agent`), ask your user for access (`datatug access request --agent`), and run inside an agent session so "This session" approvals end with the conversation. Use when a protected read is refused or an agent needs a
datatug-datasetsList, define, and read datasets in a DataTug project. Covers `datatug datasets`, `datatug dataset-def`, and `datatug dataset-data`. Use to enumerate datasets, inspect a definition, or print recordset data.
datatug-db-analyzeBuild a short, reviewable understanding of a database in a DataTug project from its metadata (tables, columns, keys), one question to the person, and docs they point to; propose a meaningful project name; save confirmed descriptions through the CLI. Use when a database was just added to a DataTug pr
datatug-initCreate a new DataTug project — scaffolds the project file layout at a specified path. Use when starting a new data exploration project.
datatug-installShow install instructions for the datatug CLI. Use when `datatug` is not on PATH, when another skill reports `command not found: datatug`, or when the user asks how to install, reinstall, or update the CLI.
datatug-mcpConnect DataTug local stdio MCP tools, discover and run saved SQL or TugQL queries on supported SQLite profiles, or explain the MCP Apps saved-query Explorer developer preview. Use for MCP client setup and saved-query exploration over MCP.
datatug-onboardingGuide a new person from an installed DataTug CLI to their first read under their own rules. Install a local demo (SQLite + inGitDB, no signup), run the Perimeter demo (an allowed read with a masked field, a refused read, a time-boxed exception they apply or reject themselves), then stop; connect the
datatug-perimeterShow and set up DataTug Perimeter, the rules for what an AI agent may read through DataTug. Run an allowed read with a masked sensitive field, a refused read, a narrow time-boxed policy exception that the person applies, narrows or rejects in their own terminal, then show the audit record. Use at th
datatug-projectsList and manage DataTug projects registered on this machine. Use to discover what projects exist, add a new one, or remove a stale entry.
datatug-queriesList and run saved queries in a DataTug project, or read a table of a project database with one `datatug query run --db datatug://...` command. Use for "show top N rows of a table" and ad-hoc investigation.
datatug-query-builderPlanned conversational DataTug query-builder contract, usable only when a connected server actually advertises its tab tools. For released local MCP saved-query exploration, use datatug-mcp.
datatug-scanAdd or update database metadata in a DataTug project by scanning a configured data source. Use after adding a new database connection, or to refresh schema metadata after upstream changes.
datatug-serveStart the DataTug HTTP server — exposes a REST API the DataTug Web UI consumes. Use during local development or to run a shared DataTug instance for a team.
datatug-uninstallPreview or remove the DataTug CLI, downloaded web UI, or the DataTug skills for Codex or Claude Code. Also covers a separate demo reset and disk usage. Use when the person asks to uninstall DataTug, reset the demo, or see how much disk space DataTug uses.
datatug-validateRun validation scripts on a DataTug project — verify metadata, queries, and pipelines are well-formed. Use as a CI gate or before committing changes.
Hooks (2)
- SessionStart
node "${CLAUDE_PLUGIN_ROOT}/scripts/agent-session.js" start
- SessionEnd
node "${CLAUDE_PLUGIN_ROOT}/scripts/agent-session.js" end
Maintain datatug?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.