Skip to content

The Dosi plugin in Codex

Codex gets dosi's MCP tools, the skills and the hooks. For what the plugin does in every agent, see The Dosi plugin.

Install

$ codex plugin marketplace add Datus-ai/dosi-plugins
$ codex plugin add dosi@dosi-plugins

Or, after the first command, open /plugins in Codex and install dosi.

Check that it works

Open a project folder and start Codex. The first session downloads dosi in the background, so give it about ten seconds. /mcp lists the dosi server and its tools; they are marked read-only, so Codex can call them without asking, in codex exec too.

Then ask a data question.

Network access

Codex's sandbox blocks the network by default. A local DuckDB or SQLite file needs nothing, but a cloud warehouse does: allow network access for the session (or for dosi's commands) before you connect one.

Update and remove

$ codex plugin marketplace upgrade dosi-plugins
$ codex plugin add dosi@dosi-plugins

Start a new session to load the new version. dosi itself is upgraded separately: say "upgrade dosi".

To remove the plugin, run codex plugin remove dosi@dosi-plugins.

Troubleshooting

Symptom Fix
network_blocked Network access is off for the session. Allow it, then ask again
install_failed The dosi download failed. In mainland China set DOSI_SOURCE=oss, then start a new session
The dosi server is missing from /mcp The first download had not finished when the session started. Start a new session