Skip to content

Fix startup model readiness and PID migration - #3

Merged
liuzhao1225 merged 1 commit into
mainfrom
agent/fix-startup-readiness
Jul 14, 2026
Merged

Fix startup model readiness and PID migration#3
liuzhao1225 merged 1 commit into
mainfrom
agent/fix-startup-readiness

Conversation

@liuzhao1225

Copy link
Copy Markdown
Owner

What changed

  • wait for CLIProxyAPI's authenticated model catalog to finish loading during setup, login, and launch
  • distinguish an unreachable catalog from a catalog that genuinely lacks the configured model
  • canonicalize macOS process start identities with a stable locale and safely migrate v0.1.0 PID files
  • preserve live legacy processes when ownership cannot yet be authenticated, and explicitly terminate new processes if PID recording fails
  • bump the patch release to v0.1.1 and update audit/install examples

Root cause

The installer queried /v1/models immediately after the proxy health endpoint became reachable. In the reported macOS run, CLIProxyAPI completed its Codex model refresh about one second later, so Claudex incorrectly reported gpt-5.6-sol as unavailable. Separately, v0.1.0 stored ps lstart using the caller's locale, making the same process identity differ across locale contexts.

User impact

Fresh installs now tolerate the short catalog-loading window without changing or silently substituting the requested model. Existing v0.1.0 macOS processes are migrated only after exact executable-path and authenticated-health checks; uncertain cases are left untouched.

Validation

  • bash -n install.sh bin/claudex scripts/*.sh
  • ShellCheck 0.11.0
  • shfmt
  • Actionlint
  • Bats: 37/37
  • locked CLIProxyAPI checksums for all four supported targets
  • v0.1.1 release package build
  • live authenticated catalog validation for gpt-5.6-sol on the reported installation

@liuzhao1225
liuzhao1225 marked this pull request as ready for review July 14, 2026 11:48
@liuzhao1225
liuzhao1225 merged commit 6246fc3 into main Jul 14, 2026
5 checks passed
@liuzhao1225
liuzhao1225 deleted the agent/fix-startup-readiness branch July 14, 2026 11:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant