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
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’sread()result changed shape to match (see Engine and bridge API). scripts/read.mjsreads a tab of a running Troy as Markdown or JavaScript Object Notation (JSON), with--url,--json,--outand--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.jsonis 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/andsrc/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_fillandpage_select, with refusals and read-back checks. - A model loop in
src/agent/llm.jsfor 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.jsthat refuses to write a key when operating system encryption is unavailable.
See Agent tool layer.
Other changes:
- The
Cdpport’surl()readslocation.hreffrom the page, andconnectOverWsalso drops Playwright’s connection handle onclose(). npm run stressalso prints private memory where Electron reports it.package.jsonauthor 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.dmgTroy-mac-x64.dmgTroy-windows-setup-x64.exeTroy-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.jsonpointshomepageat the new docs andrepositoryat github.com/velofy/troy, and adds abugslink. The Claude Code plugin manifest gainshomepageandrepository.- 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.dmgTroy-mac-x64.dmgTroy-windows-setup-x64.exeTroy-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-portandTROY_CDP_PORT, off by default, withagent-endpoint.jsonfor 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
troyandapply-fillskills. - The action scripts in
scripts/and theCdpport insrc/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.