Changelog

Unreleased

Fixed

• Stopped overriding OpenCode's own model selection with a hardcoded anthropic/claude-sonnet-4-20250514 string, which broke users authed with OpenAI / Google / other providers (ProviderModelNotFoundError → 502 in chat + AI import). OpenCode now picks its default model from whichever provider the user authed with via opencode providers login or env vars. (#174)

0.3.7 — 2026-04-20

Added

• OYSTER_DEBUG artifact-lifecycle logging (OYSTER_DEBUG=1 oyster or OYSTER_DEBUG=artifact oyster) — opt-in structured traces across MCP tool entry, OpenCode file events, watcher decisions, service layer, and reconciliation. No output when unset.

Fixed

• MCP create_artifact and register_artifact handlers now await the async service calls. Previously the tool response serialised as {} and the agent received no artifact id, triggering recovery paths that could duplicate rows.
• docs/changelog.html auto-regenerates on pushes to main that touch CHANGELOG.md or the build script — oyster.to/changelog no longer lags between releases.

0.3.6 — 2026-04-19

Fixed

• Windows: artifact appeared as C: and hung in generating forever. Watcher now uses path.isAbsolute() instead of a POSIX-only startsWith("/") check.
• Windows: dark-theme scrollbar styling on the chat panel (thin ::-webkit-scrollbar + Firefox scrollbar-color) — macOS unchanged.

0.3.5 — 2026-04-19

Added

• Right-click menu on desktop artifact tiles — Rename (inline), Archive (soft-delete), Uninstall for plugins, read-only label for builtins.
• Right-click menu on folder tiles — Rename folder, Archive folder (bulk), alongside existing Convert to Space.
• #archived view — browse soft-deleted artifacts and Restore them.
• Changelog page at oyster.to/changelog, generated from CHANGELOG.md.
• oyster --help shows 🦪 in the header.

Changed

• Docs site typography: Barlow headings paired with Space Grotesk body across landing and /plugins.
• /plugins hero renamed to "Pearls".
• Chat-bar Tab now completes the highlighted suggestion instead of executing — press Enter to execute.

Fixed

• Import resolves spaces by display_name when the slug lookup misses (prevents duplicate spaces when an agent emits a renamed space name).

Performance

• Grainient shader pauses requestAnimationFrame on window blur and tab hide (was pinning the Chrome GPU process while Oyster sat in the background). Time stays continuous on resume — no visual jump.
• Archived-paths lookup cached on ArtifactService, invalidated on mutations — /api/artifacts polling is now O(active) in steady state.

Security

• Artifact endpoints (reads and mutations) locked to localhost origins — prevents cross-origin sites from enumerating or mutating the local surface.
• JSON body size capped at 64 KB on mutation routes.

0.3.4 — 2026-04-19

Fixed

• Stale tile icons cleared after oyster uninstall <id>.

Changed

• /plugins copy button uses oyster install <id> form.

Chore

• Adopted eslint 10 in web (fixed 16 surfaced errors).
• Dependabot config for Actions and npm groups.
• Release workflow actions bumped for Node 24.
• Dep bumps: marked 17 → 18; @types/node 22 → 25; web/server/root minor+patch groups.

0.3.3 — 2026-04-18

Added

• Plugins — Tier 2 installer. oyster install <id>, oyster uninstall <id>, oyster list install community plugins by id.
• oyster install <id> resolves the repo from the mattslight/oyster-community-plugins registry.
• New /plugins catalog page on oyster.to with copy-install buttons, strict input validation, and a CDN fallback.
• Plugin system design doc.

Changed

• README and CLAUDE.md updated to match shipped v1 — port 4444, 19 MCP tools, FTS5 memory.
• /plugins page polish: hairline borders dropped, only purposeful ones kept.

0.3.2 — 2026-04-18

Added

• --version / -v flag on the oyster CLI.

Fixed

• Chat user bubble no longer conflates visually with the assistant response.

Chore

• Local discovery validation PoC script.

0.3.1 — 2026-04-17

First stable release of the 0.3 line. Bundles everything shipped across the 0.3.0 beta cycle (no stable 0.3.0 tag).

Added

• Cloud AI import. Paste from ChatGPT / Claude / Gemini and Oyster scaffolds projects, context, and memories.
  • 3-step wizard: select provider, paste AI output, preview and import.
  • Server converts any format to structured JSON via OpenCode.
  • Merge-based: detects existing spaces, skips duplicates on re-import.
  • First-run onboarding banner with "Import from AI" CTA.
• Builtin redesign. Quick Start, Connect Your AI, and Import from AI built as consistent glass-card builtins with ambient glow, pill selectors, and postMessage close support.
• Space management UI. Rename, recolour, and remove spaces directly from the UI.

Fixed

• Cross-platform (Windows):
  • Hardcoded / path separators replaced with path.basename / path.sep throughout.
  • Swapped node-pty for @lydell/node-pty — prebuilt binaries, no build tools required.
  • Auth detection checks ~/.local/share/opencode/auth.json directly.
  • Windows 403 on artifact serving (path separator mismatch).
• Stability:
  • SSE fetch no longer crashes when OpenCode dies mid-stream.
  • OpenCode port defaults to 0 (auto-select); was hardcoded 4096.
  • Kill OpenCode subprocess on shutdown; reset port on restart.

Changed

• Terminal WebSocket uses dynamic host instead of hardcoded port 4200.
• Connection banner says "oyster" (was "npm run dev").
• Helpful error when import paste yields nothing.

0.2.4 — 2026-04-15

Added

• Release scripts: release:minor, release:beta, release:promote (later simplified to release and release:beta).

Fixed

• Prod backups at ~/oyster-backups/auto/, dev at ~/oyster-backups/dev/ (were conflating).
• import-state.json stored in userland (was shared at ~/.oyster).
• Import wizard UI polish — prompt copy hint, paste area, consistent CTAs.
• Native select replaced with a custom dark-themed dropdown.

0.1.21 — 2026-04-14

Added

• Auto-backup. Userland auto-backed up on every startup to ~/oyster-backups/auto/.
  • One backup per day — repeated restarts reuse the same slot.
  • Rotates to last 5 days of history.
  • Runs before bootstrap/migration — captures pre-upgrade state.
  • Best-effort: never crashes server startup.
• MCP onboarding. "Connect your AI" builtin on the home surface with a tabbed guide for Claude Code, Cursor, VS Code, and Windsurf. CLI startup prints the MCP connect command. Landing page at oyster.to/mcp.
• Quick Start guide. 60-second overview builtin: prompt bar, slash commands, spaces, artifacts.

Changed

• Landing page MCP section: real client-specific connection snippets with tabs, actual tool-name pills.
• Nav replaced GitHub link with MCP page link.

Fixed

• Mobile: terminal mockup no longer overflows on small screens.
• "Bring Your Own AI" capitalisation and naming consistency.

0.1.17 — 2026-04-13

Added

• Drop-to-import. Drop a folder anywhere on the surface to import projects. Full-page drop zone, Grainient speeds up on drag, icons and chat dim to focus attention, wizard skips straight to scanning.
• Persistent memory. AI agent remembers across sessions.
  • MemoryProvider interface — async, storage-agnostic, swappable backends.
  • First provider: SQLite FTS5 with full-text search in a separate memory.db.
  • 4 MCP tools: remember, recall, forget, list_memories.
  • Explicit writes only — agent stores memory when asked.
• First-run onboarding. "Drop a folder to get started" hint, space-pill hint, surface-wide folder-drop trigger.
• Dev / prod separation. Dev server on port 3333, prod on 4444 — run side by side. Dev uses ./userland, prod uses ~/.oyster/userland. Version badge on surface shows version + env.

Fixed

• Icon resolution checks artifact root dir for icon.png.
• opencode.json included in npm package.

Changed

• Input placeholder cycles on blur (was static per session).
• Agent sessions use the oyster agent (was defaulting to build).
• Port resilience: OpenCode config written dynamically with actual server port; OpenCode spawned after server listens (fixes MCP connection race); Vite proxy reads OYSTER_PORT env var.

0.1.10 — 2026-04-12

Added

• Multi-folder spaces + broader scanner.
  • A space can have multiple folders (repos, project dirs, any folder).
  • space_paths table — migrates existing repo_path values automatically.
  • Add Space wizard toggles between "New space" and "Existing space".
  • Drop multiple folders onto one space. API: GET/POST/DELETE /api/spaces/:id/paths.
  • Scanner finds artifacts in Go, Rust, Python, Ruby, Java (not just JS). Root-level projects detected. Any .md found as notes. More JS frameworks: Angular, Nuxt, Astro, Remix, Solid.
  • Folder resolution searches Dropbox, OneDrive, iCloud Drive, Downloads.
• CLI packaging — npm install -g oyster-os.
  • Checks for OpenCode auth; runs opencode providers login inline on first run (OAuth in browser).
  • Spawns server process, opens browser.
  • Bootstraps ~/.oyster/userland/ with builtins (zombie-horde, the-worlds-your-oyster deck).
  • Handles SIGINT/SIGTERM cleanup.
  • Compiled server + static web serving — package is ~2.2 MB unpacked, 6 runtime dependencies.
  • node-pty moved to optionalDependencies with graceful fallback.
  • Windows support: finds opencode.cmd, uses shell: true for spawn.
  • Path traversal protection on static file serving.

Changed

• Auth flow: removed API key prompt — runs opencode providers login inline on first run.
• Renamed builtin: snake-game → zombie-horde.
• Documentation overhaul: CLAUDE.md rewritten to match shipped product; design doc updated; README rewrite for npm.
• Landing page polish: terminal window mockup with traffic-light dots; Mac/Windows OS toggle.

0.0.x — Prototype (2026-03-12 through 2026-04-11)

Milestones leading up to the first npm-packaged release, newest first.

2026-04-11 — Phase A: prompt-driven surface control

The chat bar now controls the OS. Dropped Graphiti dependency (memory deferred to v2). Added SSE command channel for instant UI push events.

• MCP tools: open_artifact(id), switch_space(id), list_artifacts with search/limit.
• Slash commands: /s <prefix> (space switch), /o <query> (artifact open) — client-side, no LLM call.
• # prefix shortcuts: #<name>, #<digit>, #., #0.
• SSE command channel at GET /api/ui/events.
• Tagline: "Apps are dead. Welcome to your surface."
• Landing page (GitHub Pages) with animated mock UI, 3D tilt panels, real FAL icons.

2026-03-30 — View toggle + kind filter polish

• View toggle (grid/list) floats next to the kind filter pill.
• List-view space tags restyled.

2026-03-29 — Spaces as first-class entities

• spaces table, SpaceStore, SpaceService. Scanner walks repos up to 4 levels deep.
• HTTP API: POST/GET/DELETE /api/spaces, POST /api/spaces/:id/scan.
• MCP onboard_space — creates space + triggers scan in one call.
• Add Space wizard: 2-step modal with drag-and-drop folder picker.

2026-03-28 — Desktop redesign

• Auto-hide topbar with view toggle, sort modes, kind filter pills, group-by.
• Drag-to-reorder icons in grid view.
• Animated space pills (framer-motion), per-space accent colours.
• Spotlight search (Cmd+K) with fuzzy filter across all artifacts.

2026-03-27 — Oyster MCP surface

Agents (Claude Code, OpenCode, Cursor, etc.) can manage the Oyster surface via MCP.

• Discovery: get_context, list_spaces, list_artifacts.
• Authoring: create_artifact, read_artifact, update_artifact, register_artifact.
• Localhost-only (non-local Origin rejected with 403), approved roots, stateless transport.

2026-03-14 — Rebrand + artifact contract + AI icons

• Global rebrand: mint green → electric indigo.
• Artifact contract: every generated output gets a folder, manifest.json, and source files under /artifacts/<id>/.
• AI-generated artifact icons — GPT-4o-mini + fal.ai Flux Schnell render geometric icons per artifact.
• Showcase deck: "The World's Your Oyster" redesign with GSAP scroll-driven reveal.

2026-03-13 — Sprint 2: wire the engine

• OpenCode terminal embedded (xterm.js + WebSocket PTY).
• HTTP+WS hybrid server with app process management.
• Space-based navigation, deck artifacts, chat API with SSE streaming.

2026-03-12 — Sprint 1: UI mockup

• Surface with Aurora WebGL animated background.
• Typed artifact icons, chat bar, window system with viewer.