@pi-lab/grok-build1.0.5
Grok Build CLI tool extension for pi coding agent
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
@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. |