---
slug: "pi-lab-webfetch"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/anthod0/pi-lab@main/README.md"
repo: "https://github.com/anthod0/pi-lab"
source_file: "README.md"
branch: "main"
---
# pi-lab

A collection of [pi coding agent](https://github.com/earendil-works/pi) extensions, packaged for `pi install`.

## Packages

| Package                                           | Description                                                             | Version                                                                                                                   |
| ------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| [@pi-lab/permissions](https://github.com/anthod0/pi-lab/tree/HEAD/packages/permissions)     | Permission system — enforce allow / deny / ask rules on tool calls      | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/permissions)](https://www.npmjs.com/package/@pi-lab/permissions)     |
| [@pi-lab/webfetch](https://github.com/anthod0/pi-lab/tree/HEAD/packages/webfetch)           | Fetch URL and get clean Markdown; includes X/Twitter fetch optimizations | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/webfetch)](https://www.npmjs.com/package/@pi-lab/webfetch)           |
| [@pi-lab/websearch](https://github.com/anthod0/pi-lab/tree/HEAD/packages/websearch)         | Search the web with Exa                                                 | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/websearch)](https://www.npmjs.com/package/@pi-lab/websearch)         |
| [@pi-lab/xsearch](https://github.com/anthod0/pi-lab/tree/HEAD/packages/xsearch)             | Search X/Twitter with xAI Grok and citation URLs                        | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/xsearch)](https://www.npmjs.com/package/@pi-lab/xsearch)             |
| [@pi-lab/grok-build](https://github.com/anthod0/pi-lab/tree/HEAD/packages/grok-build)       | Use local Grok Build for image/video and richer X search/thread reading | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/grok-build)](https://www.npmjs.com/package/@pi-lab/grok-build)       |
| [@pi-lab/env](https://github.com/anthod0/pi-lab/tree/HEAD/packages/env)                     | Load `.env` into pi sessions                                            | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/env)](https://www.npmjs.com/package/@pi-lab/env)                     |
| [@pi-lab/input-history](https://github.com/anthod0/pi-lab/tree/HEAD/packages/input-history) | `↑` recalls inputs across all sessions in the same project              | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/input-history)](https://www.npmjs.com/package/@pi-lab/input-history) |
| [@pi-lab/notify](https://github.com/anthod0/pi-lab/tree/HEAD/packages/notify)               | Desktop notifications                                                   | [![NPM Version](https://img.shields.io/npm/v/@pi-lab/notify)](https://www.npmjs.com/package/@pi-lab/notify)               |

## Install

Each package can be installed individually:

```bash
pi install npm:@pi-lab/permissions
```

Or pin to a git ref:

```bash
pi install git:github.com/anthod0/pi-lab@main
```

### X/Twitter tool comparison

All three tools can be useful, depending on the task:

| Tool         | Best for                                                             | Notes                                                                                                                                                                      |
| ------------ | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `grok_build` | Reading X posts/threads with rich context; natural-language X search | Usually gives the most complete context, including replies, quotes, media details, views, and bookmarks. Native X search typically returns about 10 posts per search call. |
| `xsearch`    | Broader X search with many citation URLs                             | Uses the xAI API-key workflow and is better when you need more search results/citations rather than deep thread context.                                                   |
| `webfetch`   | Fast, simple fetch of a single X post body                           | Usually faster and more deterministic, but returns less context than Grok Build.                                                                                           |

## Development

```bash
pnpm install

# type-check all packages
pnpm typecheck

# test an extension locally without installing
pi -e ./packages/<name>/src/index.ts

# test the compiled output
cd packages/<name>
pnpm build
pi -e ./dist/index.mjs
```