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