Agents

Use nteract as your agent notebook

nteract plugins let Claude Code and Codex run exploratory Python in a live notebook instead of hiding work in one-off shell commands. The notebook keeps state, captures rich outputs, and stays available for humans to inspect, edit, and save.

01

Choose the stable or nightly plugin

Install from the generated plugin marketplace at nteract/agent-plugins. The repository is produced by the nteract release pipeline, so the source of truth for changes remains the main nteract repo.

  • nteract: the stable plugin channel for normal use.
  • nightly: early access to the latest runtime and notebook tools.

02

Install in Claude Code

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

Claude Code pins plugins at install time. To install a known release, add --ref vX.Y.Z to the install command.

03

Install in Codex

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

After registering the marketplace, start or restart Codex, run /plugin, pick the nteract marketplace, and enable the stable or nightly plugin. Codex resolves the platform-specific sidecar bundled with the plugin.

04

What agents get

  • Create or connect to notebook-backed Python sessions.
  • Run code repeatedly while preserving variables and imports.
  • Add dependencies before or during exploratory work.
  • Inspect cells and outputs instead of reconstructing shell logs.
  • Save the resulting notebook when the exploration is worth keeping.

In practice, this gives an agent a durable scratchpad that you can open in nteract, review, and continue working on yourself.

05

Troubleshooting

  • If notebook tools do not appear, restart the agent after changing plugin or marketplace settings.
  • If the stable channel is not enough, install the nightly plugin and try the same workflow there.
  • If the agent reports runtime issues, open nteract locally and run runt doctor or runt-nightly doctor.

Want the desktop app too?

Install nteract from the homepage when you want the full native notebook interface alongside the agent plugin. The plugin makes the agent workflow available; the app gives you a friendly place to see and continue the notebook work.

Download nteract