x-twitter-pp-cli

1. Install via the Printing Press installer:
   bash

   npx -y @mvanhorn/printing-press install x-twitter --cli-only

2. Verify:

   x-twitter-pp-cli --version

3. Ensure

   $GOPATH/bin

   (or

   $HOME/go/bin

   ) is on

   $PATH

   .

npx

go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/x-twitter/cmd/x-twitter-pp-cli@latest

--version

$PATH

• x-twitter-pp-cli account-activity create-subscription

  — Creates an Account Activity subscription for the user and the given webhook.

• x-twitter-pp-cli account-activity delete-subscription

  — Deletes an Account Activity subscription for the given webhook and user ID.

• x-twitter-pp-cli account-activity get-subscription-count

  — Retrieves a count of currently active Account Activity subscriptions.

• x-twitter-pp-cli account-activity get-subscriptions

  — Retrieves a list of all active subscriptions for a given webhook.

• x-twitter-pp-cli account-activity validate-subscription

  — Checks a user’s Account Activity subscription for a given webhook.

• x-twitter-pp-cli activity create-subscription

  — Creates a subscription for an X activity event

• x-twitter-pp-cli activity delete-subscription

  — Deletes a subscription for an X activity event

• x-twitter-pp-cli activity delete-subscriptions-by-ids

  — Deletes multiple subscriptions for X activity events by their IDs

• x-twitter-pp-cli activity get-subscriptions

  — Get a list of active subscriptions for XAA

• x-twitter-pp-cli activity stream

  — Stream of X Activities

• x-twitter-pp-cli activity update-subscription

  — Updates a subscription for an X activity event

• x-twitter-pp-cli articles create_draft

  — POST /i/api/graphql/g1l5N8BxGewYuCy5USe_bQ/ArticleEntityDraftCreate

• x-twitter-pp-cli articles delete

  — POST /i/api/graphql/e4lWqB6m2TA8Fn_j9L9xEA/ArticleEntityDelete

• x-twitter-pp-cli articles list

  — GET /i/api/graphql/N1zzFzRPspT-sP9Q42n_bg/ArticleEntitiesSlice

• x-twitter-pp-cli articles publish

  — POST /i/api/graphql/m4SHicYMoWO_qkLvjhDk7Q/ArticleEntityPublish

• x-twitter-pp-cli articles update_content

  — POST /i/api/graphql/M7N2FrPrlOmu-YrVIBxFnQ/ArticleEntityUpdateContent

• x-twitter-pp-cli articles update_cover_media

  — POST /i/api/graphql/Es8InPh7mEkK9PxclxFAVQ/ArticleEntityUpdateCoverMedia

• x-twitter-pp-cli articles update_title

  — POST /i/api/graphql/x75E2ABzm8_mGTg1bz8hcA/ArticleEntityUpdateTitle

• x-twitter-pp-cli articles upload_media

  — POST /i/media/upload.json

• x-twitter-pp-cli chat add-group-members

  — Adds one or more members to an existing encrypted Chat group conversation, rotating the conversation key.

• x-twitter-pp-cli chat create-conversation

  — Creates a new encrypted Chat group conversation on behalf of the authenticated user.

• x-twitter-pp-cli chat get-conversation

  — Retrieves messages and key change events for a specific Chat conversation with pagination support. For 1:1...

• x-twitter-pp-cli chat get-conversations

  — Retrieves a list of Chat conversations for the authenticated user's inbox.

• x-twitter-pp-cli chat initialize-conversation-keys

  — Initializes encryption keys for a Chat conversation. This is the first step before sending messages in a new 1:1...

• x-twitter-pp-cli chat initialize-group

  — Initializes a new XChat group conversation and returns a unique conversation ID. This endpoint is the first step in...

• x-twitter-pp-cli chat mark-conversation-read

  — Marks a specific Chat conversation as read on behalf of the authenticated user. For 1:1 conversations, provide the...

• x-twitter-pp-cli chat media-download

  — Downloads encrypted media bytes from an XChat conversation. The response body contains raw binary bytes. For 1:1...

• x-twitter-pp-cli chat media-upload-append

  — Appends media data to an XChat upload session.

• x-twitter-pp-cli chat media-upload-finalize

  — Finalizes an XChat media upload session.

• x-twitter-pp-cli chat media-upload-initialize

  — Initializes an XChat media upload session.

• x-twitter-pp-cli chat send-message

  — Sends an encrypted message to a specific Chat conversation. For 1:1 conversations, provide the recipient's user ID;...

• x-twitter-pp-cli chat send-typing-indicator

  — Sends a typing indicator to a specific Chat conversation on behalf of the authenticated user. For 1:1 conversations,...

• x-twitter-pp-cli communities get-by-id

  — Retrieves details of a specific Community by its ID.

• x-twitter-pp-cli communities search

  — Retrieves a list of Communities matching the specified search query.

• x-twitter-pp-cli compliance create-jobs

  — Creates a new Compliance Job for the specified job type.

• x-twitter-pp-cli compliance get-jobs

  — Retrieves a list of Compliance Jobs filtered by job type and optional status.

• x-twitter-pp-cli compliance get-jobs-by-id

  — Retrieves details of a specific Compliance Job by its ID.

• x-twitter-pp-cli connections delete-all

  — Terminates all active streaming connections for the authenticated application.

• x-twitter-pp-cli connections delete-by-endpoint

  — Terminates all streaming connections for a specific endpoint ID for the authenticated application.

• x-twitter-pp-cli connections delete-by-uuids

  — Terminates multiple streaming connections by their UUIDs for the authenticated application.

• x-twitter-pp-cli connections get-history

  — Returns active and historical streaming connections with disconnect reasons for the authenticated application.

• x-twitter-pp-cli dm-conversations create-direct-messages-by-participant-id

  — Sends a new direct message to a specific participant by their ID.

• x-twitter-pp-cli dm-conversations create-direct-messages-conversation

  — Initiates a new direct message conversation with specified participants.

• x-twitter-pp-cli dm-conversations get-direct-messages-events-by-participant-id

  — Retrieves direct message events for a specific conversation.

• x-twitter-pp-cli dm-conversations media-download

  — Downloads media attached to a legacy Direct Message. The requesting user must be a participant in the conversation...

• x-twitter-pp-cli dm-events delete-direct-messages-events

  — Deletes a specific direct message event by its ID, if owned by the authenticated user.

• x-twitter-pp-cli dm-events get-direct-messages-events

  — Retrieves a list of recent direct message events across all conversations.

• x-twitter-pp-cli dm-events get-direct-messages-events-by-id

  — Retrieves details of a specific direct message event by its ID.

• x-twitter-pp-cli evaluate-note

  — Endpoint to evaluate a community note.

• x-twitter-pp-cli insights get-historical

  — Retrieves historical engagement metrics for specified Posts within a defined time range.

• x-twitter-pp-cli insights get-insights28-hr

  — Retrieves engagement metrics for specified Posts over the last 28 hours.

• x-twitter-pp-cli likes stream-compliance

  — Streams all compliance data related to Likes for Users.

• x-twitter-pp-cli likes stream-firehose

  — Streams all public Likes in real-time.

• x-twitter-pp-cli likes stream-sample10

  — Streams a 10% sample of public Likes in real-time.

• x-twitter-pp-cli lists create

  — Creates a new List for the authenticated user.

• x-twitter-pp-cli lists delete

  — Deletes a specific List owned by the authenticated user by its ID.

• x-twitter-pp-cli lists get-by-id

  — Retrieves details of a specific List by its ID.

• x-twitter-pp-cli lists update

  — Updates the details of a specific List owned by the authenticated user by its ID.

• x-twitter-pp-cli media append-upload

  — Appends data to a Media upload request.

• x-twitter-pp-cli media create-metadata

  — Creates metadata for a Media file.

• x-twitter-pp-cli media create-subtitles

  — Creates subtitles for a specific Media file.

• x-twitter-pp-cli media delete-subtitles

  — Deletes subtitles for a specific Media file.

• x-twitter-pp-cli media finalize-upload

  — Finalizes a Media upload request.

• x-twitter-pp-cli media get-analytics

  — Retrieves analytics data for media.

• x-twitter-pp-cli media get-by-key

  — Retrieves details of a specific Media file by its media key.

• x-twitter-pp-cli media get-by-keys

  — Retrieves details of Media files by their media keys.

• x-twitter-pp-cli media get-upload-status

  — Retrieves the status of a Media upload by its ID.

• x-twitter-pp-cli media initialize-upload

  — Initializes a media upload.

• x-twitter-pp-cli media upload

  — Uploads a media file for use in posts or other content.

• x-twitter-pp-cli news get

  — Retrieves news story by its ID.

• x-twitter-pp-cli news search

  — Retrieves a list of News stories matching the specified search query.

• x-twitter-pp-cli notes create-community

  — Creates a community note endpoint for LLM use case.

• x-twitter-pp-cli notes delete-community

  — Deletes a community note.

• x-twitter-pp-cli notes search-community-written

  — Returns all the community notes written by the user.

• x-twitter-pp-cli notes search-eligible-posts

  — Returns all the posts that are eligible for community notes.

• x-twitter-pp-cli openapi-json

  — Retrieves the full OpenAPI Specification in JSON format. (See...

• x-twitter-pp-cli spaces get-by-creator-ids

  — Retrieves details of Spaces created by specified User IDs.

• x-twitter-pp-cli spaces get-by-id

  — Retrieves details of a specific space by its ID.

• x-twitter-pp-cli spaces get-by-ids

  — Retrieves details of multiple Spaces by their IDs.

• x-twitter-pp-cli spaces search

  — Retrieves a list of Spaces matching the specified search query.

• x-twitter-pp-cli trends <woeid>

  — Retrieves trending topics for a specific location identified by its WOEID.

• x-twitter-pp-cli tweets create-posts

  — Creates a new Post for the authenticated user, or edits an existing Post when edit_options are provided. Supports...

• x-twitter-pp-cli tweets create-webhooks-stream-link

  — Creates a link to deliver FilteredStream events to the given webhook.

• x-twitter-pp-cli tweets delete-posts

  — Deletes a specific Post by its ID, if owned by the authenticated user.

• x-twitter-pp-cli tweets delete-webhooks-stream-link

  — Deletes a link from FilteredStream events to the given webhook.

• x-twitter-pp-cli tweets get-posts-analytics

  — Retrieves analytics data for specified Posts within a defined time range.

• x-twitter-pp-cli tweets get-posts-by-id

  — Retrieves details of a specific Post by its ID.

• x-twitter-pp-cli tweets get-posts-by-ids

  — Retrieves details of multiple Posts by their IDs.

• x-twitter-pp-cli tweets get-posts-counts-recent

  — Retrieves the count of Posts from the last 7 days matching a search query.

• x-twitter-pp-cli tweets get-webhooks-stream-links

  — Get a list of webhook links associated with a filtered stream ruleset.

• x-twitter-pp-cli tweets search-posts-recent

  — Retrieves Posts from the last 7 days matching a search query.

• x-twitter-pp-cli tweets stream-labels-compliance

  — Streams all labeling events applied to Posts.

• x-twitter-pp-cli tweets stream-posts-compliance

  — Streams all compliance data related to Posts.

• x-twitter-pp-cli tweets stream-posts-firehose

  — Streams all public Posts in real-time.

• x-twitter-pp-cli tweets stream-posts-firehose-en

  — Streams all public English-language Posts in real-time.

• x-twitter-pp-cli tweets stream-posts-firehose-ja

  — Streams all public Japanese-language Posts in real-time.

• x-twitter-pp-cli tweets stream-posts-firehose-ko

  — Streams all public Korean-language Posts in real-time.

• x-twitter-pp-cli tweets stream-posts-firehose-pt

  — Streams all public Portuguese-language Posts in real-time.

• x-twitter-pp-cli tweets stream-posts-sample

  — Streams a 1% sample of public Posts in real-time.

• x-twitter-pp-cli tweets stream-posts-sample10

  — Streams a 10% sample of public Posts in real-time.

• x-twitter-pp-cli usage

  — Retrieves usage statistics for Posts over a specified number of days.

• x-twitter-pp-cli users get-by-id

  — Retrieves details of a specific User by their ID.

• x-twitter-pp-cli users get-by-ids

  — Retrieves details of multiple Users by their IDs.

• x-twitter-pp-cli users get-by-username

  — Retrieves details of a specific User by their username.

• x-twitter-pp-cli users get-by-usernames

  — Retrieves details of multiple Users by their usernames.

• x-twitter-pp-cli users get-me

  — Retrieves details of the authenticated user.

• x-twitter-pp-cli users get-public-keys

  — Returns the public keys and Juicebox configuration for the specified users.

• x-twitter-pp-cli users get-reposts-of-me

  — Retrieves a list of Posts that repost content from the authenticated user.

• x-twitter-pp-cli users get-trends-personalized-trends

  — Retrieves personalized trending topics for the authenticated user.

• x-twitter-pp-cli users search

  — Retrieves a list of Users matching a search query.

• x-twitter-pp-cli users stream-compliance

  — Streams all compliance data related to Users.

• x-twitter-pp-cli webhooks create

  — Creates a new webhook configuration.

• x-twitter-pp-cli webhooks create-replay-job

  — Creates a replay job to retrieve events from up to the past 24 hours for all events delivered or attempted to be...

• x-twitter-pp-cli webhooks delete

  — Deletes an existing webhook configuration.

• x-twitter-pp-cli webhooks get

  — Get a list of webhook configs associated with a client app.

• x-twitter-pp-cli webhooks validate

  — Triggers a CRC check for a given webhook.

--agent

--json --compact --no-input --no-color --yes

• Pipeable — JSON on stdout, errors on stderr
• Filterable —

  --select

  keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
  bash

  x-twitter-pp-cli articles list --agent --select id,name,status

• Previewable —

  --dry-run

  shows the request without sending
• Offline-friendly — sync/search commands can use the local SQLite store when available
• Non-interactive — never prompts, every input is a flag
• Explicit retries — use

  --idempotent

  only when an already-existing create should count as success, and

  --ignore-missing

  only when a missing delete target should count as success

$ARGUMENTS

1. Empty,

   help

   , or

   --help

   → show

   x-twitter-pp-cli --help

   output
2. Starts with

   install

   → ends with

   mcp

   → MCP installation; otherwise → see Prerequisites above
3. Anything else → Direct Use (execute as CLI command with

   --agent

   )

1. Install the MCP server:
   bash

   go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/x-twitter/cmd/x-twitter-pp-mcp@latest

2. Register with Claude Code:
   bash

   claude mcp add x-twitter-pp-mcp -- x-twitter-pp-mcp

3. Verify:

   claude mcp list

1. Check if installed:

   which x-twitter-pp-cli

   If not found, offer to install (see Prerequisites at the top of this skill).
2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
3. Execute with the

   --agent

   flag:
   bash

   x-twitter-pp-cli <command> [subcommand] [args] --agent

4. If ambiguous, drill into subcommand help:

   x-twitter-pp-cli <command> --help

   .

api.x.com

x-twitter-pp-cli auth login        # opens browser, captures token
export X_OAUTH2_USER_TOKEN=<token>   # or set in config
x-twitter-pp-cli doctor            # verifies

x.com

upload.x.com

1. In Chrome, open DevTools on

   x.com

   while logged in.
2. Application → Cookies → x.com → copy

   auth_token

   and

   ct0

   values.
3. Network → reload → click any

   /i/api/graphql/...

   request → Request Headers → copy the

   Authorization: Bearer ...

   value (this is the web app's hardcoded bearer, NOT a user OAuth token).
4. Write to

   ~/.config/x-twitter-pp-cli/cookies.json

   :
   json

   {
     "auth_token": "<paste>",
     "ct0":        "<paste>",
     "web_bearer": "<paste, without the 'Bearer ' prefix>",
     "captured_at": "2026-05-08T22:00:00Z"
   }

5. chmod 600 ~/.config/x-twitter-pp-cli/cookies.json

   .

articles *

Note: Chrome's "Save all as HAR with content" SILENTLY redacts cookies and the Authorization header. Do not try to extract them from a HAR — they will be missing. Use the DevTools Application/Network tabs above.

/i/api/graphql/M7N2FrPrlOmu-YrVIBxFnQ/ArticleEntityUpdateContent

~/.config/x-twitter-pp-cli/article-ops.json

articles *

1. Re-sniff the Articles editor with the printing-press tool, OR
2. Capture a HAR via DevTools Network (any Articles operation), then:
   bash

   python3 -c "
   import json, re
   from sys import argv
   with open(argv[1]) as f: h = json.load(f)
   ops = {}
   for e in h['log']['entries']:
       g = re.search(r'/i/api/graphql/([A-Za-z0-9_-]+)/(Article[A-Za-z0-9_]+)', e['request']['url'])
       if g: ops[g.group(2)] = g.group(1)
   import os, datetime
   path = os.path.expanduser('~/.config/x-twitter-pp-cli/article-ops.json')
   with open(path, 'w') as f: json.dump({'operations': ops, 'captured_at': datetime.datetime.now().isoformat()}, f, indent=2)
   print(f'wrote {len(ops)} ops to {path}')
   " /path/to/your.har

cat > draft.md <<EOF

title: My Article cover: ./cover.png tags: [test]

• bullet one
• bullet two

x-twitter-pp-cli articles-publish-md draft.md --post

With `--post`, the command creates a draft, updates the title, uploads body images and binds them into the Draft.js `entity_map`, updates the content, uploads and assigns a cover image when `cover` is set, and publishes it as a public X Article using Source B cookie auth and the article-ops.json hash config. The wrapper requires a frontmatter `title`.

**`x-twitter-pp-cli articles set-cover <article-id> <image-file>`**

Uploads a local image through X's browser media-upload flow and assigns the returned media ID as the Article cover.

• thread compose --post

  is gated as a dry-run only. Real thread posting is the next engineering step.
• OAuth live acceptance is blocked until the registered callback setup is available.