What's New

Demo GIF & README polish

• Added demo GIF showing Navvi in action (DuckDuckGo search → GitHub)
• "OSS alternative to Browserbase & Hyperbrowser" positioning
• Fixed logo rendering on PyPI (absolute URL)
• Added CONTRIBUTING.md and star CTA

Recording tools enabled

• navvi_record_start, navvi_record_stop, navvi_record_gif are now available by default

Flow recipes

• Self-improving learned workflows — Navvi remembers how to navigate sites
• Flows match across subdomains (e.g. reddit.com ↔ old.reddit.com)

Persona context store

• Persistent knowledge store per persona (navvi_context)

Bug fixes

• Sync Marionette tab focus with VNC visual focus
• Fix navvi_fill to select-and-replace instead of appending
• Fix Firefox window maximize with Openbox config
• Clamp negative coordinates in xdotool to prevent crash
• Fix persona routing in navvi_vnc and navvi_creds
• Fix Codespace gopass persistence and jq NBSP bug
• Fix Dockerfile heredoc parse error
• Fix Codespace port forwarding (remote:local order)

Full Changelog: v3.17.1...v3.21.0

What's New

Multi-tab support (#47)

• navvi_tab tool with list, new, switch, close actions
• Run multiple pages in parallel per persona (e.g., inbox + signup form)
• Cannot close the last tab (safety guard)

Persona profiles (#54)

• profile field on personas for voice, phrases, and writing style
• Injected into generate_brief() so sessions adopt the persona's tone

Marionette zombie recovery (#55)

• Detects hung Marionette state (empty handshake bytes)
• Auto-restarts Firefox and retries failed calls
• _with_marionette_retry wrapper on all Marionette-dependent endpoints

Profile persistence fix (#50)

• Volume mount corrected: .camoufox instead of .mozilla
• Cookies, history, and sessions now survive container restart
• Codespaces persistence symlinks also fixed

JS MCP server removed (#52)

• Deleted mcp/server.mjs (1278 lines), package.json, bin/navvi.js
• Python FastMCP is the only MCP server
• CODESPACE_TOKEN replaced with standard GH_TOKEN

YAML personas removed (#52)

• Personas managed via navvi_persona MCP tool, not YAML files

Install

uvx navvi@3.17.1

Container

docker pull ghcr.io/fellowship-dev/navvi:3.17.1