Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.
feature/Install-blocks-hide-nodejs · L-260924-1ac0c2 (#1248)
Louis Choquel2a148f10fd83
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 9546de771..e733a1d22 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,5 +1,11 @@# Changelog+## [Unreleased]++### Fixed++- **The quick start says the Pipelex plugin needs Node.js**: the README's quick start and the documentation's **Quick Start** and **Pipelex Plugin** pages said, in the Claude Code install step, that the plugin needed nothing else to install. Both agents' install steps now say that the plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`; without it the hook passes silently and the tools never start.+## [v0.64.1] - 2026-09-24### Changeddiff --git a/README.md b/README.mdindex 7ba5df2c4..b9b3abbf2 100644--- a/README.md+++ b/README.md@@ -36,7 +36,7 @@ claude plugin marketplace add Pipelex/pipelex-pluginsclaude plugin install pipelex@pipelex-plugins```-Claude Code asks for an API key when you enable the plugin, and stores it in your OS keychain — create one in your console at [app.pipelex.com](https://app.pipelex.com). The skills, the hook that checks every edit and the Pipelex tools load with it; nothing else to install.+Claude Code asks for an API key when you enable the plugin, and stores it in your OS keychain — create one in your console at [app.pipelex.com](https://app.pipelex.com). The skills, the hook that checks every edit and the Pipelex tools load with it. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.Claude Code also loads what you have added to your Claude account, so if the Pipelex MCP is there, turn it off in Claude Code with `/mcp`: an agent with the plugin never takes both, since they register the same tool names.@@ -49,7 +49,7 @@ codex plugin marketplace add Pipelex/pipelex-pluginsexport PIPELEX_API_KEY=plx_sk_... # create one in your console at app.pipelex.com```-Restart Codex, run `/plugins` to install `pipelex`, and trust the plugin hook on first run. Requires Codex 0.141 or later.+Restart Codex, run `/plugins` to install `pipelex`, and trust the plugin hook on first run. Requires Codex 0.141 or later. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.</details>diff --git a/docs/features/pipelex-plugin.md b/docs/features/pipelex-plugin.mdindex 10f5905dc..ba8379713 100644--- a/docs/features/pipelex-plugin.md+++ b/docs/features/pipelex-plugin.md@@ -5,16 +5,15 @@ description: "The Pipelex plugin for Claude Code and Codex: skills that build an<!--The install commands and the sentences around them are adapted from the onboarding source's-front-door assembly, last re-read against the rendered file at Pipelex/.github@81a3728+front-door assembly, last re-read against the rendered file at Pipelex/.github@50bb5ba(onboarding/rendered/front-door.md): the blocks install/claude-code.md and install/codex.md, copied-verbatim. The Node.js sentence is this page's own: the blocks do not say it yet, and it goes once they-do. The skills, the hook and the tools summarize the plugin's own README, which stays their+verbatim, the Node.js requirement included. The skills, the hook and the tools summarize the plugin's own README, which stays theirreference.--># Pipelex Plugin-The Pipelex plugin is how you build methods with your coding agent, Claude Code or Codex: it gives your agent the skills that write and run them, a hook that checks every edit, and the Pipelex tools. It works against the hosted Pipelex API, so you need an account at [app.pipelex.com](https://app.pipelex.com) and an API key from your console there. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.+The Pipelex plugin is how you build methods with your coding agent, Claude Code or Codex: it gives your agent the skills that write and run them, a hook that checks every edit, and the Pipelex tools. It works against the hosted Pipelex API, so you need an account at [app.pipelex.com](https://app.pipelex.com) and an API key from your console there.Its source, its full documentation and its release notes are at [github.com/Pipelex/pipelex-plugins](https://github.com/Pipelex/pipelex-plugins).@@ -27,7 +26,7 @@ Its source, its full documentation and its release notes are at [github.com/Pipeclaude plugin install pipelex@pipelex-plugins```- Claude Code asks for an API key when you enable the plugin, and stores it in your OS keychain — create one in your console at [app.pipelex.com](https://app.pipelex.com). The skills, the hook that checks every edit and the Pipelex tools load with it; nothing else to install.+ Claude Code asks for an API key when you enable the plugin, and stores it in your OS keychain — create one in your console at [app.pipelex.com](https://app.pipelex.com). The skills, the hook that checks every edit and the Pipelex tools load with it. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.Claude Code also loads what you have added to your Claude account, so if the Pipelex MCP is there, turn it off in Claude Code with `/mcp`: an agent with the plugin never takes both, since they register the same tool names.@@ -38,7 +37,7 @@ Its source, its full documentation and its release notes are at [github.com/Pipeexport PIPELEX_API_KEY=plx_sk_... # create one in your console at app.pipelex.com```- Restart Codex, run `/plugins` to install `pipelex`, and trust the plugin hook on first run. Requires Codex 0.141 or later.+ Restart Codex, run `/plugins` to install `pipelex`, and trust the plugin hook on first run. Requires Codex 0.141 or later. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.Then ask your agent for the method you want, as in step 3 of the [Quick Start](../get-started/quick-start.md#3-ask-your-agent-for-the-method-you-want).diff --git a/docs/get-started/quick-start.md b/docs/get-started/quick-start.mdindex 97da5a4bf..af9eb4336 100644--- a/docs/get-started/quick-start.md+++ b/docs/get-started/quick-start.md@@ -5,13 +5,12 @@ description: "Pipelex lets you build AI methods with your coding agent and run t<!--Adapted from the onboarding source's front-door assembly, last re-read against the rendered file at-Pipelex/.github@81a3728 (onboarding/rendered/front-door.md). Every paragraph and every command is a+Pipelex/.github@50bb5ba (onboarding/rendered/front-door.md). Every paragraph and every command is ablock's own words, so a change lands in the blocks first and is then carried here. Step 3 takes thelonger first-run/agent.md rather than the assembly's agent-short.md, and the webapp and API sectionstake first-run/webapp.md, key.md, first-run/api-http.md, first-run/api-typescript.md andfirst-run/api-python.md, where the assembly only links to them. This page's own are the headings, the-content tabs standing in for the assembly's <details> wrappers, the Node.js sentence in step 2 (the-blocks do not say it yet, and it goes once they do), the sentences pointing at other pages (the SDK references are the links-tail blocks), and the closing section, since the assembly's+content tabs standing in for the assembly's <details> wrappers, the sentences pointing at other pages (the SDK references are the links-tail blocks), and the closing section, since the assembly'slast block describes the runtime repository that carries it. The Python sample's inputs dict iswrapped by this repository's ruff format, which formats Python fences in Markdown; the code is theblock's.@@ -27,7 +26,7 @@ Sign up at [app.pipelex.com](https://app.pipelex.com).## 2. Install the Pipelex plugin in your coding agent-The plugin is how you build methods: it gives your agent the skills that write and run them, a hook that checks every edit, and the Pipelex tools. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.+The plugin is how you build methods: it gives your agent the skills that write and run them, a hook that checks every edit, and the Pipelex tools.=== "Claude Code"@@ -36,7 +35,7 @@ The plugin is how you build methods: it gives your agent the skills that write aclaude plugin install pipelex@pipelex-plugins```- Claude Code asks for an API key when you enable the plugin, and stores it in your OS keychain — create one in your console at [app.pipelex.com](https://app.pipelex.com). The skills, the hook that checks every edit and the Pipelex tools load with it; nothing else to install.+ Claude Code asks for an API key when you enable the plugin, and stores it in your OS keychain — create one in your console at [app.pipelex.com](https://app.pipelex.com). The skills, the hook that checks every edit and the Pipelex tools load with it. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.Claude Code also loads what you have added to your Claude account, so if the Pipelex MCP is there, turn it off in Claude Code with `/mcp`: an agent with the plugin never takes both, since they register the same tool names.@@ -47,7 +46,7 @@ The plugin is how you build methods: it gives your agent the skills that write aexport PIPELEX_API_KEY=plx_sk_... # create one in your console at app.pipelex.com```- Restart Codex, run `/plugins` to install `pipelex`, and trust the plugin hook on first run. Requires Codex 0.141 or later.+ Restart Codex, run `/plugins` to install `pipelex`, and trust the plugin hook on first run. Requires Codex 0.141 or later. The plugin's hook and the Pipelex tools run on Node.js, so you need Node.js on your `PATH`.What the plugin holds, skill by skill, is on the [Pipelex Plugin](../features/pipelex-plugin.md) page.