Skip to content

Overview

#Pi

First-party Pi extension that adds curl.md auth and management commands plus read_web_page and curl_md tools.

#Quick Start

Install the extension, launch Pi, and start curling.

  1. Install extension

    Install the @curl.md/pi package with Pi:

    pi install npm:@curl.md/pi
  2. Start Pi

    Run Pi just like you normally do.

    pi
  3. Use Pi

    Now that Pi is running with the curl.md extension, all you need to do is use Pi. To confirm everything is set up, try this out:

    Read the curl.md Pi extension docs and summarize how it works.
    https://curl.md/docs/plugins/pi

    Pi will automatically use curl.md to turn URLs (you give it or it decides to fetch on its own) into markdown.

    Tip

    Optionally, authenticate with the curl_md_login command to unlock higher usage limits and features, like objective extraction.

#Install

Install the @curl.md/pi npm package with Pi:

pi install @curl.md/pi

Note

When the @curl.md/pi package is updated, Pi will ask if you want to update to the latest version.

If you prefer to edit config manually, add the extension to your Pi settings:

~/.pi/agent/settings.json
{
  "packages": ["npm:@curl.md/pi"]
}

Test without installing:

pi -e npm:@curl.md/pi

To update:

pi update npm:@curl.md/pi

#Usage

Ask for a page, paste links, or let Pi figure out what it needs to fetch.

#Prompting

Inside Pi, prompt like you normally would, for example:

Read the Cloudflare Agents docs and summarize the core concepts.
https://developers.cloudflare.com/agents

In this example, Pi will use curl.md to fetch the page and return markdown optimized for agents.

You can also tell Pi to use a specific objective, keywords, or let it decide what to use on its own (it’s really good at this).

#Authentication

Authenticate inside Pi to connect the extension to your curl.md account or organization:

/curl_md_login

The extension uses the same auth model as the CLI so you can also use the auth login command.

curl.md auth login

For non-interactive environments, set CURLMD_API_KEY.

#Commands

After installing, Pi registers the following commands:

CommandDescription
curl_md_loginLog in.
curl_md_logoutLog out.
curl_md_orgSwitch organization.
curl_md_statusShow status.

#Tools

The plugin also registers the following tools:

ToolDescription
curl_mdCompatibility alias for read_web_page.
read_web_pageFetch a URL as markdown.

Both read_web_page and the curl_md alias accept the following inputs:

InputTypeDescription
urlstringHTTP(S) URL or bare domain to fetch. Prefer the canonical docs or article URL.
objective?stringSpecific question to answer from the page. Use when only part matters.
keywords?string[]Keywords to focus extraction on relevant sections.
mode?rush / smartUse rush for speed or smart for better section selection on long or noisy pages.
fresh?booleanBypass cache when freshness matters.

#Status/Debugging

Use the curl_md_status command to confirm auth state, tool registration, and CLI availability.

/curl_md_status

#Contributing

We welcome contributions to make the Pi extension better. Feel free to create issues or pull requests on GitHub if there are issues or something could be improved.