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¶
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¶
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 |