Skip to content

Connect Pi to Steel

Set up your agent

Give your coding agent a Steel browser and the Steel skills, so that it browses and writes Steel code the right way. Learn more

Install the Steel CLI. It signs you in and installs the skills for your coding agents.

curl -fsS https://setup.steel.dev | sh

Or send this prompt to your coding agent, and it does the same:

Read https://setup.steel.dev/install.md and follow it to set up Steel for this coding client.
Then continue my requested task using the installed Steel skill.

Set up your agent →

Pi can open pages, click, type and fill forms in a Steel session. Pi runs shell commands, so give it the Steel CLI and the steel-browser skill, and it runs steel commands in its shell. Or install the Steel extension for Pi, @steel-dev/pi. It adds browser tools to Pi, such as steel_navigate, steel_snapshot and steel_click, so Pi drives the browser without shell commands.

Before you begin

  • Pi, installed on your machine. See pi.dev.
  • A Steel account. The CLI and the extension sign in with it.
  • A project key in the STEEL_API_KEY environment variable, if Pi runs unattended. See API keys.
  • For the Steel CLI, macOS or Linux. On Windows, use WSL.
  • Node.js 22.20 or later, for the skills installer. The extension needs Node.js 22.19 or later.

Set up the integration

Install the CLI and the skill

The prompt in Set up your agent does this step for you: send it to Pi, and it installs the CLI and the steel-browser skill and signs you in. To do it yourself, install the Steel CLI. In an interactive terminal, the installer then runs steel init, which signs you in and installs skills for coding agents.

curl -fsS https://setup.steel.dev | sh

If you skipped the sign-in, run steel login.

If steel init did not install the steel-browser skill, install it for Pi:

npx skills add steel-dev/skills --skill steel-browser -a pi -g

Restart Pi so that it finds the new skill. steel skills paths shows where each skill is installed. To have Pi write Steel code, add the steel-developer skill too. Skills lists every skill.

Add the Steel extension

Use the extension instead of the CLI when you want Pi to call browser tools. Install it with Pi:

pi install npm:@steel-dev/pi

The extension signs in with the Steel CLI's login from steel login, or with a project key in STEEL_API_KEY. To try it in one run without installing it, start Pi with pi -e npm:@steel-dev/pi.

By default, the extension keeps one Steel session open across your prompts. It releases the session when Pi calls steel_release_session or when Pi exits. To release the session after each run of the agent, set STEEL_SESSION_MODE to agent. To release it after each turn, set it to turn. The extension's README lists every tool and setting.

Check the connection

With the CLI, check the skill and CLI first:

steel skills doctor
steel scrape https://example.com

steel scrape prints the page as Markdown. Then send Pi a first task:

Use Steel to open example.com in a browser, report its title, and stop the session when finished.

Pi reports the title Example Domain.

With the extension, send Pi a prompt that needs a browser:

Use Steel to open news.ycombinator.com and list the top five stories.

Pi calls the steel_ tools, such as steel_navigate and steel_snapshot, and lists the stories.

Next steps