Repository navigation
v0.0.7
[0.0.7] - 2026-11-18
Added
- For jelly:
jelly.cost, the line jelly shows on the plugin's review before it installs: "X bills every call to
the X developer account that owns the app: about $0.005 a post read, $0.01 a user read (each post or user once per UTC
day), $0.015 a post created ($0.20 with a link). X sets the prices and can change them."
Changed
- Tested on OpenCode 2.3.1 and 2.3.2, so
TESTED_HOSTSnow holds 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.2.7, 2.3.0, 2.3.1 and
2.3.2. The supported range is unchanged (>=2.2.3 <2.4.0). The host and pack stages, CI and the release's install
check run on every one; the plugin is tested on 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.2.7, 2.3.0, 2.3.1 and 2.3.2. They need
nothing else from this plugin: between 2.3.0 and 2.3.2 the only API changes are thatexperimental.generate
excludes video jobs and a newcodemodesession event kind.
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 withaccess: 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, whichx_media_uploadand 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-statusand the status RPC
say "sign-in required" and name it, and/connectmarks the X account "sign in again". Add the scope to the X app
if it lacks it, then sign in once more.x_media_uploadwas 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_uploador 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. -
X lists only each feed's most recent posts. X keeps a limited number of each feed's newest mentions, timeline posts
and bookmarks (its 800 most recent bookmarks). A collector that falls behind, or a first listing from further back,
could miss posts. A feed source answers the contract'sgaponce when that may have happened (configuration).
Sourcexanswers no gap. -
A deleted post is not reported. A post X stops listing because its author deleted it, or a bookmark you removed,
is simply not listed again; an event already listed stays with the consumer. It makes no gap: nothing was lost. -
A feed source notices a change of X account only when told.
x_events_list's feed sources never ask X who is
signed in, because that identity read isprobe's until Memory and jelly accept a source that declares it
(permission.readsIdentity, in the source contract they pin). If you sign in to X as another account,
a feed notices only when its caller passes the new account (the old account's cursor is thenACCOUNT_MISMATCH) or
callsprobe. Until then a cursor reads its own account's feed: X refuses bookmarks and the home timeline of anyone
but the signed-in user, and mentions are public posts. Sourcexasks X on every call. -
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.accessis 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
xurlbridge 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/connectand 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 setscriptBudgetUsdorscriptDailyBudgetUsd. The answers under
Cost lines carry their cost line and/x-statusshows 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 updateandopencode plugin checkdo not work on one: to move to a newer release, remove the old entry and add the new tag.