Dexly Companion

Dexly Companion is the local native-messaging bridge that connects the Dexly Chrome extension to a local Codex app-server on macOS, Windows, and Linux.

Requirements

• macOS, Windows, or Linux
• Google Chrome
• Node.js 20+

The public npm install flow is cross-platform. Repo-local development helper scripts remain POSIX-oriented for now.

Install

npx -y @dexlyai/dexly install
npx -y @dexlyai/dexly doctor

Alternative global install:

npm i -g @dexlyai/dexly
dexly install

Update

npx -y @dexlyai/dexly upgrade

Publish

From the companion repo:

npm run release:set-version -- 0.1.5
npm run publish:npm:latest

Other channels:

npm run publish:npm:beta
npm run publish:npm:canary

Release policy and the publishable companion version are maintained from one manifest:

• release/companion-release.json

Sync derived files without changing the version:

npm run release:sync

npm run release:set-version -- <semver> updates the manifest version and syncs the derived files. Review minimumVersion and recommendedVersion in the same manifest before publishing if the rollout policy should change with that release.

Commands

• install: install or repair the companion, launcher, and Chrome native-host manifest
• doctor: verify the install layout, launcher, manifest, and local Codex availability
• upgrade: install a newer companion version and repoint the active install
• rollback: reactivate the previous known-good companion version
• install-codex: install Codex through npm using the companion's captured tool paths
• host: run the native host on stdin/stdout
• version: print the companion package version

Codex

Dexly Companion does not silently install Codex during companion install. If Codex is missing, Dexly prompts from the extension after companion health succeeds.

Manual Codex install:

npm install -g @openai/codex

OpenAI Codex CLI docs: https://help.openai.com/en/articles/11096431-openai-codex-ci-getting-started