v0.5.0

[0.5.0] — 2026-06-15

Added

• iris mcp — smart proxy with auto-start (packages/server). Run iris mcp --drive <url> and you're
  done: it starts the daemon if one isn't running, waits for it to be ready, then bridges Claude Code's stdin/stdout to the daemon's SSE endpoint. Users no longer manage the daemon manually.
• iris mcp --drive <url> / iris serve --drive <url> — pass a URL and Iris launches its own
  Playwright browser at that URL, giving the agent full autonomous control without relying on the user's open browser tab.
• iris mcp --headed / --headed flag — opt in to a visible browser window so you can watch exactly what the agent is doing.
• Three new update MCP tools (packages/server):
  • iris_version_info — returns the installed version, execution kind (npx / global / local), and
    whether a newer version is available on npm.
  • iris_apply_update — upgrades Iris in place; requires confirm: true to actually run.
  • iris_rollback — downgrades to the previous version; requires confirm: true.
• Presenter mode (packages/browser, packages/server) — iris.connect({ present: true }) mounts a
  dev-only HUD overlay that the agent can control: iris_narrate shows a caption, iris_highlight
  draws a ring around any element. The HUD is excluded from snapshots and tree-shaken in production.
• Unified SKILL.md at repo root — a single skill file auto-detects mode: setup wizard on first
  run (no .iris.json), live-app testing on every run after. Covers Claude Code, OpenCode, Codex CLI, Cursor, Windsurf, VS Code, and Zed MCP config formats.
• .iris.json project config — written after first-run setup; persists port, headed,
  framework, and harnesses so subsequent runs need zero questions.
• dev:iris script in apps/demo — second Vite dev server on port 4310, isolated from the user's normal dev port.

Fixed

• All-throttled session auto-selection (packages/server). When every connected tab is hidden
  (e.g. user is in VS Code with Chrome on another desktop), SessionManager.resolve() now picks the session with the freshest heartbeat instead of throwing "multiple sessions connected".
• Presenter HUD shows on bridge connect — the overlay now mounts as soon as the SDK connects to the bridge, not only after the first iris_narrate call.
• iris_narrate MCP schema validation — relaxed the output schema so the tool no longer rejects responses from narration calls.
• iris_inspect / iris_clock output schemas — relaxed to pass through extra fields instead of stripping them, fixing spurious validation errors.