Codex

Install from a local checkout

From the DataPorch repository:

codex plugin marketplace add /absolute/path/to/dataporch
codex plugin add dataporch@dataporch

The repository marketplace is also available:

codex plugin marketplace add adamraziv/dataporch --ref main

Connect to the local runtime

After installing the plugin, initialize and start the runtime:

dataporch secrets init
dataporch run

The plugin’s .mcp.json starts dataporch mcp as a stdio server. The command forwards MCP messages over DataPorch’s owner-only local Unix socket and reads the runtime credential from its protected local state. You do not need to create, copy, or export an MCP token. The runtime must already be running; dataporch mcp does not start it.

For a client that needs the HTTP transport instead, see direct HTTP MCP authentication.

Update or remove

codex plugin marketplace upgrade dataporch
codex plugin remove dataporch@dataporch

The plugin does not launch the DataPorch runtime. Start it separately and verify /healthz first.