Skip to content
Troy

Troy / Project

Changelog

Troy release history and the unreleased changes on main, from GitHub Releases, the changelog and the commits, with downloads and notable behaviour.

On this page
  1. Unreleased (main)
  2. v0.1.5
  3. v0.1.4
  4. v0.1.0 to v0.1.3

This page follows GitHub Releases and, from v0.1.5, the CHANGELOG.md file in the repository. Earlier entries also draw on the repository tags and the product requirements document (PRD). The unreleased section comes from the commits on the main branch since the v0.1.5 tag, because CHANGELOG.md does not list them yet.

Unreleased (main)

Changes on main since v0.1.5, up to 23 October 2026, most of them from pull request #1 (agent/deeper-tools). None is in a release yet: Homebrew and the download links still install v0.1.5, and package.json on main still says 0.1.5. Run from source to use these.

The read pipeline:

  • Settle, extract, cover, transcribe and fuse, in src/read/. Reads structure from the Document Object Model (DOM), drops hidden text with the reason it was dropped, nominates only the regions the DOM cannot explain for optical character recognition (OCR), and orders the result into reading order. See How Troy reads a page.
  • The agent panel runs it. read this page now shows block and region counts, timing, settle status and the page as Markdown, instead of the first 4,000 characters of innerText. The panel’s read() result changed shape to match (see Engine and bridge API).
  • scripts/read.mjs reads a tab of a running Troy as Markdown or JavaScript Object Notation (JSON), with --url, --json, --out and --fetch-mode=reap.
  • An Apple Vision OCR engine (src/read/apple-vision.js, macOS only). Nothing passes it to the pipeline yet, so cover regions are reported as untranscribed.
  • 9 new tests for the pipeline against the article, hidden-text and canvas fixtures.

The browser:

  • Remember history works. Visits are recorded in history.json (at most 500) while the switch is on, and the file is deleted when it is turned off.
  • The new tab shortcut grid is removed. The search box, settings and keyboard hints remain.
  • The About panel on macOS describes the project.
  • agent-endpoint.json is written atomically, to a temporary file renamed into place.
  • Tracker blocking treats a tracker request whose initiator is not a web page as third party.
  • Packaging includes src/read/ and src/agent/.

The agent tool layer (library code, not wired into the app):

  • Seven tools in src/agent/tools.js: page_read, page_text, page_scrape, page_navigate, page_click, page_fill and page_select, with refusals and read-back checks.
  • A model loop in src/agent/llm.js for Anthropic, OpenAI and OpenRouter, with a consent gate for actions and a cap of 12 tool calls per turn.
  • An encrypted key store in src/agent/keys.js that refuses to write a key when operating system encryption is unavailable.

See Agent tool layer.

Other changes:

  • The Cdp port’s url() reads location.href from the page, and connectOverWs also drops Playwright’s connection handle on close().
  • npm run stress also prints private memory where Electron reports it.
  • package.json author is now Velofy. The README leads with the app tile and labels NodeMaven as the primary sponsor.
  • A September 2026 bugs and enhancements spec was added under docs/spec/.
  • The suite has 226 tests in 16 files, up from 127.

v0.1.5

Published 30 September 2026 as “Troy v0.1.5”. A documentation and metadata release: the browser is the same as v0.1.4.

Downloads:

  • Troy-mac-arm64.dmg
  • Troy-mac-x64.dmg
  • Troy-windows-setup-x64.exe
  • Troy-windows-portable-x64.exe

What changed:

  • Documentation moved to https://velofy.co/troy/.
  • README: the Homebrew command is now brew install --cask velofy/tap/troy, downloads are listed, and Documentation and Contributing sections were added.
  • package.json points homepage at the new docs and repository at github.com/velofy/troy, and adds a bugs link. The Claude Code plugin manifest gains homepage and repository.
  • Added CHANGELOG.md.

The builds are ad-hoc signed only, not signed with a developer certificate and not notarised. See Installation for the first-launch steps. The Homebrew cask now requires macOS 12 (Monterey), which matches the minimum the app declares.

v0.1.4

Published 12 September 2026 as “Troy v0.1.4”. This was the first release and tag in the velofy/troy repository.

Downloads:

  • Troy-mac-arm64.dmg
  • Troy-mac-x64.dmg
  • Troy-windows-setup-x64.exe
  • Troy-windows-portable-x64.exe

Release note: unsigned builds. On macOS, first launch of a manual download needs Control-click then Open. On Windows, SmartScreen asks you to choose More info then Run anyway.

What this version contains:

  • The Troy browser: Chromium tabs under Troy’s own chrome, an address bar with scheme refusals, a new tab page with shortcuts and settings, failure pages that keep the address, crash recovery and an error log, and a real application menu.
  • The agent bridge: --cdp-port and TROY_CDP_PORT, off by default, with agent-endpoint.json for discovery.
  • The agent panel with a DOM-only read of the active tab.
  • Tracker blocking and tracking parameter stripping, on by default.
  • Unpacked extensions loaded from the profile.
  • The Claude Code plugin manifest (plugin version 0.2.0) with the troy and apply-fill skills.
  • The action scripts in scripts/ and the Cdp port in src/cdp/.
  • 127 tests, run on macOS, Windows and Linux in continuous integration (CI).

Known gaps at this version: the read pipeline and OCR are not built, and the Remember history switch records nothing. See Roadmap.

v0.1.0 to v0.1.3

The PRD records five public releases, v0.1.0 to v0.1.4, published on 8 and 9 August 2026 with macOS disk image (DMG) and Windows executable (EXE) builds and the Homebrew cask. The current repository starts at v0.1.4, and the earlier versions have no release notes here, so their individual changes are not listed.