Skip to content

v0.0.2

Choose a tag to compare

@github-actions github-actions released this 14 Nov 21:10
· 22 commits to master since this release
1b51e64

[0.0.2] - 2026-11-14

Added

  • test/fixtures/live-tools.json, Tavily's tool list for a signed-in user, captured live on 14 November 2026, and a
    test that fails when the declaration and that list disagree. The declaration already matches it: 5 tools, each
    readOnly as Tavily's readOnlyHint says, each allow.

Changed

  • Jelly: the key sign-in's label is "Tavily API key" (it was "Tavily"), so the card says it is a key. docs/jelly.md
    says that only the key serves OpenCode's websearch; with the account alone, web search uses Tavily's keyless
    access. Turning the websearch setting off only stops the plugin choosing Tavily as OpenCode's web search provider.
  • The icon is Tavily's Brand Mark, unmodified, on a white rounded holding tile with clear space of its own height, used under Tavily's brand guidelines. opencode.vendor.mark is true, and the README names Tavily Inc. as the trademark owner.
  • package.json is "private": true, so nothing can be published to npm by mistake. Installs from the GitHub release
    tag are unaffected.
  • test/unit/check-icons.test.ts checks scripts/check-icons.mjs (contract revision 2) on scratch copies of this package: the family rules without opencode.vendor.mark, and the vendor's own mark, its README notice and trademark line with it.

Known limits

  • Five tools. The plugin knows the five Tavily tools. A tool Tavily adds later is not classed by the plugin: the access option decides whether it runs, asks or is denied, and /tavily-status counts it as unknown.
  • Research and crawl cost the most. Research takes minutes with no progress shown, and a call stops after 15 minutes. Crawl reads up to 50 pages by default. The plugin sets no spending limit: each call spends Tavily credits as the tool does.
  • No retries. A failed call returns UPSTREAM_ERROR with its next step. The plugin does not retry it.
  • Web content is not trusted. A page can carry instructions, and nothing asks by default. The tavily skill tells the model not to follow them, but that is a rule for the model, not a guard in the plugin.
  • A shell key does not reach the server. A TAVILY_API_KEY exported only in a terminal does not reach a running OpenCode server. See Sign in.
  • Hosts and platforms. The plugin is tested on 2.2.3, 2.2.4, 2.2.5 and 2.2.6, and runs on macOS or Linux. A later 2.2 release starts and is reported as untested.
  • Web search needs the key. Only a Tavily API key serves OpenCode's websearch; signed in with a Tavily account alone, it uses Tavily's keyless access.
  • Jelly. The settings declare their choices and bounds, which only a Jelly that includes app#1301 reads; an older Jelly refuses the plugin's declaration.
  • 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.