Skip to content

v0.0.1

Choose a tag to compare

@github-actions github-actions released this 13 Nov 00:28
· 68 commits to master since this release
b228998

[0.0.1] - 2026-11-13

Changed

  • Script budgets are opt-in. scriptBudgetUsd and scriptDailyBudgetUsd are unset by default, so a script has no
    per-session or daily budget and nothing in the plugin refuses or clamps its calls for cost; X's own billing, rate
    limits and the app's spending limit apply. A number you set works as before, the persisted daily ledger included,
    and any positive amount is accepted: the 1000 ceiling that treated a large value as a typo is gone. Every result
    still carries its actual cost line, and /x-status shows the estimated 24-hour spend, against a cap when one is set.
  • Model reads are not capped. The plugin no longer forces a page of at most ten or strips next-page tokens: a read's
    max_results and pagination pass to X unchanged on the model path, in Code Mode and from scripts, and X validates
    them against its own limits (scripts were clamped to 100, below some endpoints' own maximum). The skill and the
    namespace text drop the page, per-answer spend and widening guidance. Every answer that read still ends with its
    actual cost line.
  • events.maxCalls has no fixed ceiling. It still defaults to 4, must be at least 2 and at most
    Number.MAX_SAFE_INTEGER; the 50 ceiling is gone. One x_events_list call stops a feed's walk when X hands back a
    page token it already followed, so a looping token cannot keep billing.

Known limits

  • The tool table was checked against X's live list on 2026-11-06. X publishes no tool annotations, so each
    tool's class comes from its name, description and schema. X may add, rename or remove tools; an unknown one is allowed with access: all
    before it runs, and a known one can be missing for a token with fewer scopes.

  • A public app refreshes. X issued a Native App (public client) a refresh token on 2026-11-06, and OpenCode
    refreshed it about two hours later; offline.access is still required.

  • There is no delete or Article-publish tool. A Post published by mistake is removed in the X app; an Article
    draft has no publish tool here, so it stays a draft until the user publishes it in X.

  • X's xurl bridge is an alternative, not this plugin's route. X documents
    npx -y @xdevplatform/xurl mcp https://api.x.com/mcp, which holds your app, opens a browser at the first tool call,
    and caches the token in ~/.xurl. It moves the sign-in outside /connect and its calls outside these permission
    rules, needs a Node download and a child process, and OpenCode cannot see its sign-in state, so this plugin does not
    use it. It remains a working fallback if you need a local bridge and accept that.

  • A script's session must be in the project you call. A session in another directory is SESSION_UNKNOWN, and a
    call that names no location goes to the service's default location, so send -H "x-opencode-directory:$PWD" with
    every call. This is in the module shared with the other plugins, not in this one.

  • In Jelly, a tool X adds is not asked about. Jelly applies each declared tool's effect and nothing else, so an
    undeclared tool, a write included, runs without asking until a release of this plugin declares it. A Jelly admin
    can set it to ask.

  • The plugin does not cap spending. Reads pass to X as the model or a script asks, with no page or result cap,
    and scripts have no budget unless you set scriptBudgetUsd or scriptDailyBudgetUsd. Every answer that read ends
    with its actual cost line and /x-status shows the estimated 24-hour spend; X's Developer Console has the real bill,
    and the app's spending limit there caps the account.

  • X's prices are X's. The rates above are from X's pricing page on 5 November 2026, and can change without
    notice.

  • Updates are not automatic for a Git install, and opencode plugin update and opencode plugin check do not work on one: to move to a newer release, remove the old entry and add the new tag.