All notable changes to this fork are documented here. For upstream history, see pasky/chrome-cdp-skill.
The format follows Keep a Changelog
and this fork uses Semantic Versioning
with a -fork suffix to distinguish from upstream releases.
1.0.0-fork — 2026-04-16
First tagged release of the fork. Baseline: upstream commit 1fd55c7.
- AgentX profile resolver (
scripts/agentx.mjs) — maps AgentX profiles by id or name to their CDP endpoint. Reads%APPDATA%\AgentX\data.dbvia the built-innode:sqlitemodule. Subcommands:list,path,env,cdp,doctor. doctorsubcommand — 10-check self-diagnostic: Node version, platform,%APPDATA%, AgentX install,data.db, profiles directory, profile count, running state, siblingcdp.mjs, Claude skill junction. Outputs[OK]/[WARN]/[INFO]/[FAIL]levels with actionable messages and exits non-zero if any[FAIL]is reported.uploadcommand inscripts/cdp.mjs— attach a local file to<input type="file">viaDOM.setFileInputFiles, bypassing the native OS file picker dialog.docs/AGENTX-WITH-CLAUDE.md— end-to-end guide for connecting AgentX profiles to Claude Code, including multilingual trigger phrase examples (English / Russian / Ukrainian / Polish / any other).package.jsonwithengines.node >= 22.5.0, fork authorship (@paskyas upstream,@cryptoyasenkaas fork maintainer), and fork-specificrepository/homepage/bugsURLs.- GitHub Actions CI — smoke tests on Ubuntu + Windows across Node
22.5 / 22.x / 24.x matrix: syntax check,
--helpexit status,doctorerror-path verification. - Self-respawn with
--experimental-sqliteon Node 22.x.node:sqliterequires the flag on the Node 22 LTS line (it was added in 22.5 behind the flag; the flag was dropped only on the 23+ Current line and stays dropped on 24+). Rather than force users on Node 22 LTS to type the flag,agentx.mjsdetects Node 22.x and re-execs itself with the flag automatically. End- users never see the flag; the floor stays at 22.5.
- Node.js 22.5+ is now a hard requirement. The resolver uses
node:sqlite, which was added in Node 22.5.0. Upstreamcdp.mjsalready required Node 22+ for the globalWebSocket. The floor is enforced viaenginesinpackage.json, a runtime check indoctor, and prominent notes in README / SKILL.md / docs. - README.md — adds a "What this fork adds" section, cmd.exe and PowerShell install snippets, browser compatibility table, and a doctor verify step.
- SKILL.md — Claude-facing skill instructions now include an AgentX section and explicitly tell the model to match on intent in any human language.
- The Node "SQLite is experimental" warning is suppressed by
intercepting
process.emitbefore the default warning printer runs.process.on('warning')listeners fire in addition to the default printer, so that approach would not silence the message.