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