Skip to content

v0.0.3

Choose a tag to compare

@github-actions github-actions released this 14 Nov 21:50
· 51 commits to master since this release
3067463

[0.0.3] - 2026-11-14

Added

  • x_media_upload, which X now lists, is known and declared to Jelly as a write (readOnly: false, effect allow):
    it uploads a file and returns its id for a Post or DM. create_posts' new clip input is recorded.
  • Jelly's x sign-in declares its scopes: the plugin's default oauth.scopes, sorted.
  • test/unit/live-tools.test.ts checks jelly.tools against X's tool list as Code Mode's catalogue showed it on
    2026-11-14 (test/fixtures/live-tools.json, names and inputs only, because OpenCode's sign-in to X was refused).

Changed

  • The default X sign-in now asks for media.write, so media_upload works: if you are already signed in to X, sign in
    once more after updating. /x-status and the status RPC then say "sign-in required" and name the missing scope, and
    /connect marks the X account to sign in again, whenever the scopes X granted the sign-in lack one the plugin asks
    for.
  • media_upload and the chat media methods (chat_media_download, chat_media_upload_initialize,
    chat_media_upload_append, chat_media_upload_finalize) have no price row: X's pricing page gives them none, and
    the chat media rows were guesses. With a script budget set, a script's call to one is refused with
    X_PRICE_UNKNOWN; without one it runs, and its cost line says the price is unknown (estimateUsd and actualUsd
    null, basis: "unknown"). Every script result's cost now carries basis.
  • DENY_TOOLS is now SENSITIVE_TOOLS, and their class sensitive: the 40 privacy-sensitive tools have been allowed
    with the rest at access: all since 0.0.2, and the old name said otherwise. docs/jelly.md no longer says Jelly
    applies the declaration "instead" of a base rule while also saying a declared allow changes nothing.
  • package.json is "private": true: the plugin installs from its GitHub release tag
    (github:joe-broadhead/opencode-x#v<version>), never from npm.
  • The icon is now X's own logo, the path x.com serves in its 24×24 viewBox, unmodified, on a white rounded holding tile, in place of the family's Neutral slate tile; opencode.vendor.mark is true.

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 sign-in from before an upgrade can lack a new default scope. This version's default sign-in asks for
    media.write, which x_media_upload and the chat media tools need. X records the scopes it granted with the
    sign-in, and the plugin compares them with the ones it asks for: when one is missing, /x-status and the status RPC
    say "sign-in required" and name it, and /connect marks the X account "sign in again". Add the scope to the X app
    if it lacks it, then sign in once more. x_media_upload was listed by Code Mode's catalogue of X's tools on
    2026-11-14, names and inputs only, because OpenCode's sign-in to X was refused that day.

  • Media uploads have no published price. X's pricing page gives none for x_media_upload or the chat media tools,
    so the plugin does not guess one: a script with a budget set is refused them (X_PRICE_UNKNOWN), and without a
    budget their cost line says the price is unknown. X's Developer Console has the real bill.

  • 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.

  • Jelly. The settings declare their choices and bounds, which a Jelly needs app#1301 to read; an older Jelly turns the declaration down. The script budgets are declared in whole cents from $0.01, so Jelly cannot save a fraction of a cent that the options take in opencode.json.

  • 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.