Skip to content

The Dosi plugin in Claude Code

Claude Code gets the whole plugin: dosi's MCP tools, the skills, the hooks, and an interface of its own (a status line, /dosi and a lineage pane). For what the plugin does in every agent, see The Dosi plugin.

Install

At the Claude Code prompt:

/plugin marketplace add Datus-ai/dosi-plugins
/plugin install dosi@dosi-plugins

Then run /reload-plugins, or start a new session. On Claude Code 2.1.275 or later, one line does both steps: /plugin install dosi --marketplace Datus-ai/dosi-plugins. From a shell:

$ claude plugin marketplace add Datus-ai/dosi-plugins
$ claude plugin install dosi@dosi-plugins

Check that it works

Open a project folder and start a session. The first session downloads dosi in the background, so give it about ten seconds, then:

  • /mcp lists plugin:dosi:dosi as connected. The server starts with the session and follows dosi/model.yaml, so it runs before the model exists and picks the model up once it is written.
  • /dosi shows the connection, the model and whether it validates, and the next step.

Then ask a data question. Claude answers through dosi's tools, and does not ask permission for dosi's own calls.

What only Claude Code has

None of this changes what Claude reads; every step works the same without it.

  • Status line: the live state of the project, for example dosi · duckdb:local · 3 ds · 8 metrics · ontology 3.
  • /dosi: the connection, the model, counts of datasets, metrics and dimensions, the ontology, and the next step. /dosi metrics lists every metric with its description.
  • /dosi lineage [metric]: a pane that draws what a metric is computed from, or what depends on a table. Press h to write the HTML page as well.
  • Result tables: a dosi result shows as a table with its source and row count, and the SQL one click away. A failed command shows as the error, its cause and what to try next.
  • Suggestions: once you have asked a few questions, the plugin suggests the lineage view, and later an ontology, once each.

Update and remove

$ claude plugin marketplace update dosi-plugins
$ claude plugin update dosi@dosi-plugins

Restart Claude Code to load the new version. dosi itself is upgraded separately: say "upgrade dosi".

To remove the plugin, run /plugin uninstall dosi@dosi-plugins. That also removes the dosi it downloaded.

Troubleshooting

Symptom Fix
Plugin "dosi" not found in any marketplace Your Claude Code is older than 2.1.275. Use the two-line install
/mcp shows plugin:dosi:dosi as failed The first download had not finished when the session started. Reconnect it in /mcp, or start a new session
Claude runs dosi in the shell instead of the tools An older plugin without the MCP server is installed. Update it as above