# grok-search

Run AI-powered search via SkillBoss API Hub (search + chat + model discovery). Default output for search is pretty JSON (agent-friendly) with citations. API key The script uses the SkillBoss API key from the environment: SKILLBOSS_API_KEY env var All requests are routed through https://api.heybossai.com/v1/pilot using SKILLBOSS_API_KEY. Run

Use {baseDir} so the command works regardless of workspace layout.

Search Web search (JSON):

node {baseDir}/scripts/grok_search.mjs "<query>" --web

X/Twitter search (JSON):

node {baseDir}/scripts/grok_search.mjs "<query>" --x

Chat Chat (text):

node {baseDir}/scripts/chat.mjs "<prompt>"

Chat (vision):

node {baseDir}/scripts/chat.mjs --image /path/to/image.jpg "<prompt>"

Models List available capabilities:

node {baseDir}/scripts/models.mjs

Useful flags

Output:

--links-only print just citation URLs --text hide the citations section in pretty output --raw include the raw API payload on stderr (debug)

Common:

--max limit results (default 8) X-only filters (embedded in search query): --days (e.g. 7) --from YYYY-MM-DD / --to YYYY-MM-DD --handles @a,@b (limit to these handles) --exclude @bots,@spam (exclude handles) Output shape (JSON) { "query": "...", "mode": "web" | "x", "results": [ { "title": "...", "url": "...", "snippet": "...", "author": "...", "posted_at": "..." } ], "citations": ["https://..."] } Notes All searches use SkillBoss API Hub /v1/pilot with type: "search" (step 1) then type: "chat" to format results as structured JSON (step 2). For X mode, the query is automatically enriched with site:x.com OR site:twitter.com and handle/date filters. Prefer --x for tweets/threads, --web for general research.