codexmate v0.0.42

What's Changed

• fix: protect remote web access and copy session paths by @awsl233777 in #186

Contributors

• @awsl233777

Full Changelog (v0.0.41 → v0.0.42): 6ffef78...v0.0.42

codexmate v0.0.41

Release Notes

Features

• Web UI Port Auto-Selection: When default port 3737 is unavailable, automatically probe next available ports (3738, 3739, ..., up to 20 attempts)
• Explicit Port Protection: When CODEXMATE_PORT is set, strictly use the specified port without probing
• Enhanced Error Handling: Gracefully handle EADDRINUSE and EACCES errors during port detection

Technical Changes

• Add resolveAvailableWebPort() function for sequential port probing
• Integrate async port resolution into cmdStart startup flow
• Add isWebPortExplicit() to detect user-set ports
• Maximum probe attempts: 20 ports (configurable)

Documentation

• Update README.md, README.zh.md, and site/index.md with CODEXMATE_PORT usage examples
• Document auto-increment behavior and explicit port usage

Testing

• All 577 tests passed
• Add coverage for port exhaustion path
• Add EACCES handling test cases

Compatibility

• Fully backward compatible
• Default: auto-probe ports 3737+ when unavailable
• Explicit CODEXMATE_PORT: strict mode, no probing

Fixes

• Fix #183: Handle unavailable Web UI ports gracefully

---

Contributors

• @solarhell
• @ymkiux

Full Changelog: v0.0.40...v0.0.41

codexmate v0.0.40

Highlights

v0.0.40 focuses on safer configuration management and broader Web UI localization.

• Added Vietnamese (vi) as a selectable Web UI language.
• Split the large Web UI i18n dictionary into per-locale modules for zh, en, ja, and vi.
• Localized remaining plugin / prompt-template UI chrome and built-in prompt template text.
• Hardened i18n fallback behavior so missing translations fall back cleanly instead of leaking raw keys.
• Added explicit Web UI / API write gates for external Codex and Claude configuration changes.
• Bumped package metadata from 0.0.39 to 0.0.40.

Safer config writes

Web UI and API actions that mutate external Codex or Claude config are now read-only by default. Users must explicitly enable the relevant write switch before those actions can modify external tool configuration.

Covered write paths include:

• Codex provider add / update / delete and config-template writes.
• Claude config writes.
• Codex local bridge exclusion settings.
• Claude local bridge exclusion and provider-sync settings.

Direct CLI config commands remain usable and are intentionally not blocked by the Web UI read-only default, preserving fresh-install and upgrade compatibility for CLI users.

Existing local config/provider entries are not silently removed by this change. The new gate prevents new Web UI / API driven writes while disabled; cleanup of historical config remains explicit.

Validation

Validated before release:

• WEB_UI_PARITY_BASE_REF=6315a171a54806ae69934ad44be7fa8a646bbc43 npm run test → unit tests passed (573) and E2E passed.
• npm run lint → passed for 310 files.
• git diff --check → passed.
• GitHub checks on the release PR head passed: ci (18), ci (20), ci (22), build, and CodeRabbit.

Earlier localization validation also covered:

• Browser matrix scan across 4 languages × 13 page states.
• Live language switching across zh, en, ja, and vi.
• Plugins / prompt-template hardcoded-copy regression checks.

Release assets

• codexmate-0.0.40.tgz
• codexmate-0.0.40-standalone.tar.gz

Links

• PR: #179
• Fixed issue: #182

Contributors

• @awsl233777
• @babyskill

codexmate v0.0.39

Highlights

• Moved language switching into Settings so the sidebar/header stay focused on navigation while language remains easy to change.
• Expanded localization coverage across Settings, Webhook, Trash, provider forms, Codex config controls, dialogs, and toast/status messages.
• Hardened runtime language switching so translated UI text, dynamic toasts, and fallback labels update more consistently.
• Improved the built-in proxy streaming fallback: aborted upstream streaming retries now happen before any client-visible SSE output is emitted, avoiding broken partial streams.

Web UI

• Added Settings language selector UI and supporting layout polish.
• Localized remaining visible labels for Settings quick options, Webhook controls, Trash actions, provider validation/errors, modal actions, and related status text.
• Kept config mode labels and sidebar language affordances aligned with the active locale.
• Refreshed the precompiled Web UI render bundle so packaged builds include the localization updates.

Proxy / Runtime

• Updated the built-in proxy Responses shim to retry streaming aborts safely before sending output to clients.
• Added regression coverage for the proxy streaming abort retry behavior.

Validation

• Added/updated unit coverage for Web UI behavior parity and built-in proxy Responses shim behavior.
• Bumped package metadata to 0.0.39.

Full Changelog

v0.0.38...v0.0.39

Contributors

• @awsl233777

codexmate v0.0.38

Highlights

Analytics export for external reporting

• Added /analytics export support for exporting usage data as CSV or JSON.
• Supports date-range filtering and model filtering for BI analysis or archival workflows.
• Exports token usage, session counts, and model breakdown data from the existing session usage backend.
• Handles empty result sets gracefully instead of crashing or generating malformed output.

Closes #139 via #178.

Web UI fixes included since v0.0.37

• Keeps the sidebar version and trash tab visible after the recent web UI layout changes (#176).
• Fixes skill import from the Web UI by sending the expected items payload instead of imports (#177).

Version

• Bumped package metadata to 0.0.38 (package.json and package-lock.json).

Validation

• npm run test:unit -- --match analytics passed locally; the test runner reported all 535 unit tests passed.
• GitHub CI for #178 passed on Node 18 / 20 / 22.

Changed files

• cli.js
• cli/analytics-export-args.js
• cli/session-usage.js
• package.json
• package-lock.json
• tests/unit/analytics-export-args.test.mjs
• tests/unit/run.mjs
• tests/unit/session-usage-backend.test.mjs
• web-ui/modules/skills.methods.mjs

Contributors

• @awsl233777
• @ymkiux

Full Changelog: v0.0.37...v0.0.38

codexmate v0.0.37

What's Changed

Fixed

• Fixed the sidebar end-scroll behavior so the 回收站 (Trash) tab can scroll fully into view above the fixed language switcher. This addresses #175.
• Kept the sidebar Codex Mate version visible without requiring hover, and refined the sidebar brand/version text sizing.
• Removed the inert sidebar brand tab stop so the brand area no longer becomes an unnecessary keyboard focus target.

Docs

• Removed the obsolete codexmate setup command from the npm quick-start examples in both README.md and README.zh.md.

Chores

• Bumped package metadata to 0.0.37.
• Removed the temporary tracked TODO.md file.

Validation

• npm run test:unit — all 530 unit tests passed.
• npm run lint — 300 files passed.
• git diff --check — passed.
• Headless Chrome scroll check at 1280x520 confirmed the 回收站 tab is fully visible after scrolling the sidebar to the end.

Related

• PR: #176
• Issue: #175

Contributors

• @ymkiux
• @awsl233777

codexmate v0.0.36

Highlights

• Refined the Web UI brand header with a smaller, cleaner logo block, lighter typography, hover-revealed version text, and better gradient/fallback styling.
• Simplified session time display to stable absolute timestamps, avoiding noisy relative-time labels and improving behavior around incomplete session data.
• Stabilized Web UI navigation and URL handling: canonical root redirects, preserved query strings, static URL behavior, and stronger no-cache handling for served UI assets.
• Improved session discovery by scanning recent .jsonl files that may be missing from the session index.
• Switched the packaged Web UI path toward precompiled runtime assets so the browser build no longer relies on Vue runtime compilation or unsafe-eval.
• Expanded regression coverage for URL canonicalization, session tab navigation, render parity, asset serving, and session UI behavior.

Changed

• Web UI brand/header redesign and responsive polish.
• Session timestamp formatting and guards for malformed session records.
• /web-ui/index.html now redirects to the canonical root URL while preserving query parameters.
• Dynamic/static Web UI asset responses now use explicit Cache-Control: no-store, max-age=0 where appropriate.
• Package version bumped to 0.0.36.

Pull Request

• #173

Contributors

• @ymkiux

Full Changelog: v0.0.35...v0.0.36

codexmate v0.0.35

Highlights

• Fixed sessions, CSP, and settings behavior across the Web UI.
• Redesigned the Usage tab with the “River of Time” visual treatment.
• Strengthened URL routing and normalization, including duplicate /web-ui path handling.
• Moved the Web UI toward a single canonical root entry point and static URL behavior.
• Hid/disabled local provider selection in Codex/Claude config mode where appropriate.
• Renamed claude-local presentation to local with a system badge.
• Redesigned the Skills tab into a more minimal single-column layout.
• Avoided a runtime Vue compiler dependency by using precompiled render assets.

Changed

• Added URL routing and normalization tests.
• Restored missing CI scripts in package.json after the release-line correction.
• Updated unit coverage to match the new Web UI structure and parity allowlists.
• Preserved sessions tab rendering during navigation.
• Package version bumped to 0.0.35.

Pull Requests

• #168
• #170

Contributors

• @awsl233777
• @ymkiux

Full Changelog: v0.0.34...v0.0.35

codexmate v0.0.34

Highlights

• Added Claude local bridge improvements, share command work, session utilization display, and broader Web UI improvements.
• Added a template editor to the Claude config panel.
• Added a Claude-local provider card with model auto-sync behavior.
• Addressed security audit findings across OWASP-oriented categories.
• Redesigned the settings panel toward a more minimalist layout.
• Fixed Web UI loading under the tightened CSP.

Changed

• Kept Claude session timestamps fresher and added timestamp fallback handling.
• Cleared session URL parameters when leaving the sessions tab.
• Package version bumped to 0.0.34.

Pull Requests

• #166
• #167

Contributors

• @ymkiux
• @awsl233777

Full Changelog: v0.0.33...v0.0.34

codexmate v0.0.33

Highlights

• Refined the Web UI across all major tabs.
• Added Claude share command support and updated related tests.
• Added session context-window utilization warnings.
• Improved search behavior for CJK token matching and stabilized E2E coverage.
• Improved Codex/Claude provider editing UI, including API-key visibility toggles.
• Added, then removed, an experimental Windows tray running indicator after follow-up stability work.
• Modernized README styling and consistency.

Changed

• Moved version presentation into the brand/header area and simplified layout.
• Kept the language switcher visible at the sidebar bottom.
• Removed provider health result displays while keeping health-check controls/hints.
• Added codexmate update command.
• Package version bumped to 0.0.33.

Pull Requests

• #165

Contributors

• @ymkiux

Full Changelog: v0.0.32...v0.0.33