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:
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:
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:
/mcplistsplugin:dosi:dosias connected. The server starts with the session and followsdosi/model.yaml, so it runs before the model exists and picks the model up once it is written./dosishows 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 metricslists every metric with its description./dosi lineage [metric]: a pane that draws what a metric is computed from, or what depends on a table. Presshto 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¶
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 |