@wipcomputer/wip-grok

WIP Computer

wip-grok

xAI Grok API. Search the web, search X, generate images, generate video. All from one module.

Sensor: search_web, search_x ... turns questions into knowledge. Actuator: generate_image, edit_image, generate_video ... turns prompts into media.

Zero dependencies. Four interfaces: CLI, Module, MCP Server, Skill.

Install

Open your AI coding tool and say:

Clone wipcomputer/wip-grok and read the README and SKILL.md.
Then explain to me:
1. What is this tool?
2. What does it do?
3. What would it change or fix in our current system?

Then ask me if I have more questions, or if I want you to integrate it into our system.

Your agent will read the repo, explain the tool, and walk you through integration interactively.

API Key

Get your xAI API key from https://console.x.ai/

The tool resolves your key automatically:

• 1Password (preferred) ... op://Agent Secrets/X API/api key. No env vars needed.
• Environment variable ... export XAI_API_KEY="your-key" as a fallback.

Usage

CLI

# Search (sensor)
wip-grok search-web "latest AI regulation developments"
wip-grok search-x "what people are saying about OpenAI"
wip-grok search-x "AI thoughts" --handles=elonmusk,kaboré --from=2026-01-01

# Image generation (actuator)
wip-grok imagine "a cat in space, photorealistic" --output=cat.png
wip-grok imagine "minimalist logo" --aspect=16:9 --n=4

# Image editing (actuator)
wip-grok edit "make the sky purple" --image=photo.jpg --output=edited.jpg

# Video generation (actuator)
wip-grok video "a sunset timelapse over the ocean" --duration=10 --resolution=720p --wait
wip-grok video "animate this image" --image=photo.jpg --output=animated.mp4

# Check video status
wip-grok video-status abc123

As a Module

import { search_web, search_x, generate_image, generate_video, wait_for_video } from '@wipcomputer/wip-grok';

// Sensor: search
const web = await search_web({ query: "UN climate summit" });
console.log(web.content);
console.log(web.citations);

const x = await search_x({
  query: "AI regulation",
  allowed_x_handles: ["elonmusk"],
  from_date: "2026-01-01",
});

// Actuator: generate
const img = await generate_image({ prompt: "a red cube on white", aspect_ratio: "1:1" });
console.log(img.images[0].url);

const vid = await generate_video({ prompt: "spinning globe", duration: 5 });
const result = await wait_for_video({ request_id: vid.request_id });
console.log(result.url);

MCP Server

Add to your .mcp.json:

{
  "wip-grok": {
    "command": "node",
    "args": ["/path/to/wip-grok/mcp-server.mjs"]
  }
}

Exposes 6 tools: grok_search_web, grok_search_x, grok_imagine, grok_edit_image, grok_generate_video, grok_poll_video.

Functions

Sensor (Search)

Function	What	Endpoint
search_web	Web search via Grok	POST /v1/responses (web_search tool)
search_x	X/Twitter search via Grok	POST /v1/responses (x_search tool)

Actuator (Generate)

Function	What	Endpoint	Cost
generate_image	Text to image	POST /v1/images/generations	$0.02/image
edit_image	Edit image with text	POST /v1/images/edits	$0.022/image
generate_video	Text/image to video	POST /v1/video/generations	$0.05-0.07/sec
poll_video	Check video status	GET /v1/video/generations/:id	free
wait_for_video	Poll until complete	(convenience wrapper)	free

Attribution

Search functions ported from castanley/grok v1.0.3 by Christopher Stanley on ClawHub.

License

MIT

Built by Parker Todd Brooks, with Claude Code and Lēsa (OpenClaw).