Agents: Show Your Work

A live notebook for Claude Code and Codex. State persists. Outputs stay rich. Every step is yours to inspect, edit, and keep.

Claude Code

/plugin marketplace add nteract/agent-plugins
/plugin install nteract@nteract
# nightly channel:
/plugin install nightly@nteract

Plugins pin at install time. Add --ref vX.Y.Z for a known release.

Codex

codex plugin marketplace add \
  nteract/agent-plugins
# then run /plugin in Codex and
# enable nteract or nightly

Restart Codex after changing plugin or marketplace settings.

Updating the Codex plugin

The desktop app and agent plugin update separately. If notebook calls fail with unsupported_notebook_target or “This child does not advertise required notebook_handle routing,” an older plugin may be rejecting your updated app. The plugin needs updating even if the error says to upgrade the child.

Save your notebook work, then run this in a terminal for the stable plugin. For Nightly, replace nteract@nteract-plugins with nightly@nteract-plugins in both commands.

Refresh and reinstall

codex plugin marketplace upgrade nteract-plugins &&
codex plugin remove nteract@nteract-plugins &&
codex plugin add nteract@nteract-plugins

The && operators stop if a step fails. If the marketplace clone times out or reports “early EOF,” stop before removing the plugin. Follow the recovery guide for a shallow local checkout or a pinned marketplace.

Restart Codex and start a fresh session to load the updated plugin and tools. Reconnecting the notebook worker alone does not upgrade the plugin. Ask the agent to create a notebook and run 1 + 1; confirm the cell returns 2.

What agents get

Notebook-backed Python sessions that keep variables and imports between runs.
Dependencies added before or during exploratory work.
Cells and rich outputs to inspect instead of reconstructed shell logs.
A durable scratchpad. Save the notebook when the exploration is worth keeping.

Download nteractTools missing? Check the plugin upgrade steps or run nteract doctor.