@pi-lab/grok-build

A pi extension that adds a single grok_build tool backed by the local Grok Build CLI.

The tool intentionally stays prompt-only: Grok Build is itself an agent, so pi gives it a natural-language task and lets Grok choose its own image, video, web, and X/Twitter capabilities.

Requirements

Install and authenticate Grok Build first.

Capability guidance

| Capability | Guidance | | -------------------------- | -------------------------------------------------------------------------------------------- | | Image generation | ✅ Recommended | | Image edit | ✅ Recommended | | Video generation | ✅ Recommended | | X/Twitter search | ✅ Recommended when Grok-native user, semantic, or advanced keyword search is useful | | X/Twitter post/thread read | ✅ Use Grok Build for detailed context; use webfetch when faster, simpler output is enough | | General web search | ⚠️ Available but not recommended; prefer other websearch tool | | General web fetch | ⚠️ Available but not recommended; prefer other webfetch tool | | Coding tasks | ❌ Not recommended |

Install

pi install npm:@pi-lab/grok-build

Usage

Ask pi for image or video generation, for example:

Use Grok Build to generate an image of a cyberpunk red panda mascot.

The tool accepts only one argument: prompt. Grok decides how to satisfy the request.

X/Twitter usage

Prefer grok_build for X/Twitter tasks when Grok Build is installed and authenticated. It uses the local Grok agent, understands natural-language requests, and can read richer post/thread context than the API-key based xsearch tool.

grok_build can handle common X/Twitter requests in natural language:

Search X for recent reactions to the latest Grok Build release.
Read this X thread and summarize the main points: https://x.com/...

For X/Twitter links, Grok Build usually returns richer context such as replies, quoted posts, media details, views, and bookmarks.

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. |