WIP Computer

wip-xai-x

X Platform API. Read posts, search tweets, post, upload media.

Built on the official @xdevplatform/xdk TypeScript SDK (v0.4.0, MIT, zero transitive deps).

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

Install

Open your AI coding tool and say:

Clone wipcomputer/wip-xai-x 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.

Authentication

The tool resolves credentials automatically:

1. 1Password (preferred) ... vault "Agent Secrets", item "X Platform API"
2. Environment variables ... as a fallback

Read-only (fetch posts, search, user lookup):

export X_BEARER_TOKEN="your-bearer-token"

Read + Write (post tweets, bookmarks, upload media):

export X_API_KEY="your-api-key"
export X_API_SECRET="your-api-secret"
export X_ACCESS_TOKEN="your-access-token"
export X_ACCESS_TOKEN_SECRET="your-access-token-secret"

Get credentials at https://developer.x.com/en/portal/dashboard

Usage

CLI

# Sensor (read)
wip-xai-x fetch https://x.com/parkertoddbrooks/status/123456
wip-xai-x search "AI agents" --max=20
wip-xai-x bookmarks --max=10
wip-xai-x user parkertoddbrooks
wip-xai-x me

# Actuator (write)
wip-xai-x post "Hello from wip-xai-x"
wip-xai-x post "Replying!" --reply-to=123456
wip-xai-x post "Check this out" --media=photo.jpg
wip-xai-x delete 123456
wip-xai-x bookmark 123456
wip-xai-x upload photo.jpg

As a Module

import { fetch_post, search_recent, post_tweet, get_bookmarks } from '@wipcomputer/wip-xai-x';

// Sensor: read
const post = await fetch_post({ id_or_url: 'https://x.com/user/status/123' });
console.log(post.data.text);

const results = await search_recent({ query: 'AI agents', max_results: 10 });
for (const tweet of results.data) {
  console.log(tweet.text);
}

const bookmarks = await get_bookmarks({ max_results: 20 });

// Actuator: write
const { data } = await post_tweet({ text: 'Hello from wip-xai-x' });
console.log(`Posted: https://x.com/i/status/${data.id}`);

MCP Server

Add to your .mcp.json:

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

Exposes 7 tools: x_fetch_post, x_search_recent, x_get_bookmarks, x_get_user, x_post_tweet, x_delete_tweet, x_upload_media.

Functions

Sensor (Read)

Function	What	Auth
fetch_post	Fetch a post by ID or URL	Bearer
search_recent	Search tweets (last 7 days)	Bearer
get_bookmarks	Get your bookmarks	OAuth
get_user	Get user profile	Bearer
get_me	Get your own profile	OAuth

Actuator (Write)

Function	What	Auth
post_tweet	Post a new tweet	OAuth
delete_tweet	Delete a tweet	OAuth
bookmark_post	Bookmark a post	OAuth
unbookmark_post	Remove a bookmark	OAuth
upload_media	Upload image/video/gif	OAuth

Bearer = read-only bearer token. OAuth = OAuth 1.0a with all four tokens.

wip-xai-x vs wip-xai-grok

	wip-xai-x	wip-xai-grok
API	X Platform API (api.x.com)	xAI API (api.x.ai)
Search	Raw tweet data, exact matches	AI-powered search via Grok
Read posts	Fetch by ID, search by query	Not available
Write	Post tweets, upload media	Generate images/video
Auth	Bearer token / OAuth 1.0a	xAI API key

Use wip-xai-x to read/write on X. Use wip-xai-grok for AI-powered search and media generation.

Attribution

Built on @xdevplatform/xdk v0.4.0 (official X TypeScript SDK).

---

License

MIT

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