v0.3.0

🏗️ Build Information

Field	Value
📦 Version	0.3.0
🏷️ npm	latest — published as @mirrowel/opencode-openshare@0.3.0
🌿 Channel	latest
🔗 Commit	c0fde59
📅 Release date	2026-11-06
⚡ Trigger	workflow_dispatch
🧩 Parts changed	cli plugin server viewer worker tools

📥 Install

opencode plugin @mirrowel/opencode-openshare@latest --global

📋 What's Changed

The 0.2.1 viewer already had twelve views, virtualization, scoped
search, live streaming, multi-user accounts, and copy-as-markdown.
0.3.0 is a trust and portability release around that base: shares can
leave the server as offline files, the server gains scoped credentials
and per-share controls, and the project gains a website, an admin
console, and CI-owned releases.

Viewer

• Thinking panel (classic and conversation): the reasoning body is
  now a capped 26rem scroll panel with drag-to-resize, an open/close
  pour animation, and an end-of-thought mark; closed panels unmount
  their markdown. Plain tool outputs pour open the same way; file
  cards keep the kit's native mount.
• File cards gained per-theme code palettes, media rendering for
  image/SVG/audio reads and writes, bottom-edge drag-resize, and
  range-language stamping so mid-script reads and edits highlight
  correctly. The existing pierre highlighting, line numbers,
  path-first relative titles, and the 20-line cap remain.
• Output surfaces: shell, text results, and unregistered tools
  (MCP, ctx_*) share one resizable card with copy, wrap/scroll, a
  clipped-content fade, and a catch-all renderer.
• Search gained one store behind the palette and every skin
  filter; every prompt of a parallel burst is searchable.
• Deep links: ctrl+click a message copies #row=<key>; the link
  scrolls to the exact row, expands it, flashes it, and survives
  reloads.
• Subagent cards link to the exact child prompt they spawned (the
  plugin stamps both sides; a token-alignment ladder resolves old
  shares); per-agent colors and a synced running sweep on active
  cards.
• Timestamps shown as recorded (UTC), click to convert the whole
  session to your timezone.
• Transcript menu: copy markdown, export import-ready JSON,
  download a snapshot — one header menu.
• Tool gallery (npm run preview:tools) now covers whole-message
  features as well as every tool state.
• View picker: classic and conversation flat; reader and the nine
  skins behind "more views".
• Layout hardening: measurement, disclosure, resize, and
  navigation survive mass expand/collapse, reloads, width changes, and
  session switches.

Server and trust

• Scoped tokens: full and scoped osk_ credentials; scoped tokens
  create within their limits and reach only their own shares; rotation
  transfers attribution. Revoking the last full token freezes the
  account; per-token freeze; code-lineage kill switch; ask-once
  onboarding (CODELESS_ONBOARDING restores codeless minting).
• Token management: self-mint, edit, rotation overrides,
  minute/hour/day expiry, and named config sets (Class A server-side,
  Class B suggestions).
• Per-share settings: general < per-server < per-share for TTL,
  read auth, sticky title, and pause (writes reject 423 while paused,
  backfill on resume).
• Hours-native TTL: ttlHours everywhere; ttlDays converts ×24;
  one-hour floor; legacy rows migrate lazily.
• Redaction at the enqueue choke point with a consent preflight
  showing counts; custom regex patterns configurable.
• Private facts: directory/worktree leave the public session item
  (pmeta), served only past the read gate; machine paths rewritten
  session-relative on the wire.
• Share meta API: owner/admin-only summaries, gates, liveness,
  expiry, provenance; single-share freeze.
• Config: OPENSHARE_CONFIG_JSON one-env config, JSON urlFile
  lines, share meta labels.

Snapshots and interchange

• Offline snapshot: one self-contained HTML (~7 MB) from the
  header menu, tools/osh-snapshot.mjs, or straight from
  opencode export; opens from file:// with highlighting, diffs,
  math, and subagent pages; gated shares demand auth; the server
  endpoint is off by default.
• Session interchange: tools/osh-session.mjs exports, packs, and
  imports sessions between the share envelope, opencode export, and
  opencode import.

TUI and plugin

• Share dashboard in /share (status, links, per-share settings,
  danger zone); /openshare regrouped into This session / Servers /
  Config / Interface with per-server defaults and effective-value
  tiers.
• Stderr ladder: all / status / url / off; errors always print.
• TUI fixes: keyboard-navigable confirm dialogs, no menu clipping;
  plugin version in the settings title; manual-mode detection fixed on
  case-sensitive filesystems.

Embeds and website

• Per-share OG cards: five styles (aurora default), gated shares
  get a generic card, OG_STYLE selects.
• Marketing site on GitHub Pages with two curated demo sessions
  rendered by the real viewer.

Pipeline and tooling

• Release kit: VERSION base record, releases computed and
  stamped in CI with write-back, hollow-publish gating, manual notes
  and dry-run, release artifacts (viewer dist, CI bundle, plugin
  tarball, osh console).
• Version surfaces: /health, viewer footer, plugin title — all
  from shipped manifests.
• Vendored kit pinned: exact-commit pin in vendor-v2.mjs +
  vendor:check canary + VENDOR.md catalogue.
• Tests: quick gate in CI on every push; new
  console/pause/pairing/engine/TUI-reactivity suites; full local
  matrix ~258s → ~141s with zero checks deleted.
• Comparison build: build-legacy.mjs --ref <any> serves any ref
  under /compare.

Breaking changes

• Zero-config enrollment on public servers no longer creates a user;
  shares go out anonymously until onboarding. Set
  CODELESS_ONBOARDING=1 to restore.
• TTL is hours-native (ttlDays accepted, converted ×24).
• Comparison builds live under /compare.

📦 Release Artifacts

Asset	Description
viewer-dist-0.3.0.zip	The built share-viewer web app (static dist). Self-hosting: unpack into the worker's assets directory or point the Bun server's VIEWER_DIR at it.
mirrowel-opencode-openshare-0.3.0.tgz	The npm plugin tarball, byte-identical to the registry. Offline or air-gapped install: opencode plugin --global.
openshare-ci-0.3.0.js	Single-file plugin bundle for GitHub Actions: configured entirely through environment (OPENSHARE_CONFIG_JSON), no install step.
osh-0.3.0.mjs	Standalone admin console for any OpenShare server: node osh-0.3.0.mjs (Node 20+).

🔗 Useful Links

• 📖 Documentation
• 🌐 Website
• 🐛 Report Issues
• 📦 npm package
• 🌟 Star this repo if you find it useful!
• 📜 Full changelog

v0.3.0-dev.20

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.20 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.20
npm tag	dev
Channel	dev
Commit	3565934

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: viewer
npm: not published (no plugin changes since the last published version)

What's Changed

Features

• feat(viewer): ✨ group the view picker into cores plus a more-views disclosure (3565934) by @Mirrowel

Fixes

• fix(ci): 🐡 generate release notes from the repo root, not the package cwd (af27366) by @Mirrowel

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.19

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.19 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.19
npm tag	dev
Channel	dev
Commit	6b98aa7

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: plugin viewer
npm: published as @mirrowel/opencode-openshare@0.3.0-dev.19

What's Changed

No notable changes.

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.18

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.18 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.18
npm tag	dev
Channel	dev
Commit	260c477

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: plugin server viewer worker
npm: published as @mirrowel/opencode-openshare@0.3.0-dev.18

What's Changed

Features

• feat(viewer): ✨ subagent cards link to the paired child prompt (914d165) by @Mirrowel
• feat(tui): ✨ share dashboard and regrouped settings around the tier model (a259a5c) by @Mirrowel
• feat(plugin): ✨ three-tier share settings — general, per-server, per-share (91161a4) by @Mirrowel

Fixes

• fix(tui): 🐛 clearing a share override never told the server (e5dafb2) by @Mirrowel
• fix(tui): 🐛 a false Show sibling made dialogs throw at mount under the test renderer (5b7c17c) by @Mirrowel
• fix(tui): 🐛 menu with divider clipped its own rows; confirm buttons reflowed on focus switch (58d9557) by @Mirrowel
• fix(tui): 🐛 confirm dialogs had no keyboard surface, reading as frozen (cdc5f37) by @Mirrowel

Documentation

• docs: 📚 share-settings tiers across the configuration and TUI surfaces (5cbb225) by @Mirrowel

Tests

• test(plugin): ✅ task-pairing coverage: ladder fixtures and an engine stamp scenario (3488b7a) by @Mirrowel
• test: ✅ pin the share-settings tiers and the pause lifecycle end to end (565391c) by @Mirrowel

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.17

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.17 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.17
npm tag	dev
Channel	dev
Commit	fdf2d4c

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: plugin worker
npm: published as @mirrowel/opencode-openshare@0.3.0-dev.17

What's Changed

Fixes

• fix(plugin): 🐛 manual-mode detection missed tui.json on case-sensitive fs (95d6dcc) by @Mirrowel
• fix(tests): 🐛 first CI run of the suites could not pass anywhere (73a9c41) by @Mirrowel
• fix(ci): 🐛 smoke step hung after a successful boot (6c6bf0c) by @Mirrowel
• fix(ci): 🐛 workerd cannot start on ubuntu-24.04 runners without userns (2e49345) by @Mirrowel
• fix(tests): 🐛 shared-worker boot slides on runner port conflicts (e943fd3) by @Mirrowel
• fix(tests): 🐛 slide the matrix port block when the runner holds a port (8d6b939) by @Mirrowel

Maintenance

• chore(ci): 🧹 rebuild the standalone bundle for the case-preserving walk (fdf2d4c) by @Mirrowel

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.16

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.16 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.16
npm tag	dev
Channel	dev
Commit	3666c51

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: plugin server viewer worker tools
npm: not published (no plugin changes since the last published version)

What's Changed

CI

• ci(tests): 🎡 run the quick gate on every push and PR (5889be4) by @Mirrowel

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.15

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.15 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.15
npm tag	dev
Channel	dev
Commit	7a417ea

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: cli plugin server viewer worker
npm: published as @mirrowel/opencode-openshare@0.3.0-dev.15

What's Changed

Fixes

• fix(tests): 🐛 two suites were killing other suites' workers mid-wave (a43582e) by @Mirrowel

Performance

• perf(tests): ⚡️ full matrix 170s -> ~135s, quick ~65s -> ~55s wave (841f346) by @Mirrowel
• perf(tests): ⚡️ fanout concurrent serve tracks (solo 155s -> ~65s) (4b01e65) by @Mirrowel

Tests

• test: ✅ cut suite fat, add the wave budget gate, bun-backed quick auth (61e7e1f) by @Mirrowel
• test(v2): ✅ multi-remote engine-edge scenarios on the scripted bus (34bdd22) by @Mirrowel

Maintenance

• chore(ci): 🧹 rebuild the standalone bundle for the binding-write knob (7a417ea) by @Mirrowel

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.14

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.14 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.14
npm tag	dev
Channel	dev
Commit	663623c

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: cli plugin server viewer worker tools
npm: published as @mirrowel/opencode-openshare@0.3.0-dev.14

What's Changed

Features

• feat(plugin): ✨ four-position stderr ladder adds banner-without-url (45c7b47) by @Mirrowel
• feat(plugin): ✨ announceStderr becomes a 3-position stderr ladder (96451fc) by @Mirrowel

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.13

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.13 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.13
npm tag	dev
Channel	dev
Commit	b7c13a5

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: plugin server viewer worker
npm: published as @mirrowel/opencode-openshare@0.3.0-dev.13

What's Changed

Features

• feat(api): ✨ private share meta surface, single-share freeze, token provenance and minute-granularity expiry (b7c13a5) by @Mirrowel

Other Changes

• [skip ci] release: 0.3.0-dev.12 (2c6a0c0) by @release-bot

Links

• npm package
• Repository
• Issues
• Full changelog

v0.3.0-dev.12

Warning

This is a prerelease from the dev channel. It may contain incomplete or unstable changes.

Use the exact version 0.3.0-dev.12 when reporting issues.

Package

Field	Value
Version	0.3.0-dev.12
npm tag	dev
Channel	dev
Commit	84dfd3a

Install

opencode plugin @mirrowel/opencode-openshare@dev --global

Scope

Parts changed: plugin server viewer worker
npm: not published (no plugin changes since the last published version)

What's Changed

Features

• feat(auth): ✨ token editing API and rotation overrides (85a3ed1) by @Mirrowel

Other Changes

• [skip ci] release: 0.3.0-dev.11 (e0e1dd0) by @release-bot

Links

• npm package
• Repository
• Issues
• Full changelog