Getting startedBuild With AgentsAgent Harnesses

Pi

View as MarkdownOpen in Claude

Pi is a minimal terminal coding harness from Earendil Inc. The @youdotcom-oss/pi package registers five You.com skills and bridges You.com MCP tools into Pi for web search, page content, research, finance, and docs lookup. They’re the same skills the Claude Code, Cursor, and Codex plugins install.

Install our docs MCP server

This documentation ships with a Docs MCP Server that gives any MCP-enabled agent a searchDocs tool to search every page here and get back relevant passages with source URLs—no API key required. Point your client at https://you.com/docs/_mcp/server. See the Docs MCP Server guide for setup and examples.

Quick Setup

1

Install the You.com Package

pi install npm:@youdotcom-oss/pi

The package includes the you-web, you-research, you-finance, you-discover, and you-free skills, keyless you-search, authenticated You.com MCP tools for page content, research, and finance, and the You.com Docs MCP tools.

To install only the skills, without the bridged MCP tools, use the Agent Skills installer from your project root:

npx skills add youdotcom-oss/agent-skills
2

Set Your API Key

Keyless you-search and the Docs MCP tools work without a key. The authenticated tools read YDC_API_KEY. Set it before launching Pi:

export YDC_API_KEY="<YDC_API_KEY>"

Get a key at you.com/platform.

3

Start Pi

pi
4

Try It

Inside a Pi session:

Search the web for the latest TypeScript 5.5 release notes and summarize the breaking changes.

Pi activates the relevant skill automatically when a task involves search or page extraction.

Keyless Tier

Want to try it without signing up? The free profile runs you-search and you-discover (100 queries/day, no auth) when no API key is set—leave YDC_API_KEY unexported and Pi will fall back to the keyless endpoint. Page extraction and deep research require a key, and research/finance need the matching MCP path or allowlist.

Quick Demo

Research the trade-offs between Pi's skill model and MCP for capability extension. Cite sources.
Extract the install methods from https://pi.dev/docs/latest and turn them into a checklist.

SDK Users: OpenClaw

Building agents with an SDK rather than running them in a terminal harness? The same skills work with OpenClaw—see the agent-skills repo for SDK-side integration.

Troubleshooting

Install Pi from pi.dev and confirm with pi --version.

Confirm the package installed with pi install npm:@youdotcom-oss/pi, then restart Pi. If you used npx skills add, confirm the skill files are in your project. See pi.dev/docs/latest for Pi’s skill-discovery rules.

Confirm YDC_API_KEY is exported in the shell that launched Pi, not just in a sub-shell, and starts with YDC-.

Set YDC_API_KEY to lift the cap and unlock you-contents. you-research and you-finance need an explicit allowlist or the dedicated MCP paths.

Resources

Agent Skills

Skill catalog, install commands, and usage examples.

SDKs & Tools Overview

Browse every You.com SDK, agent tool, and integration.