Claudexor

Claudexor

Use the MCP tools supplied by this plugin. They connect to the user's local Claudexor installation; they do not provide accounts or remote model access.

Preconditions

• Support macOS and Linux. Do not claim Windows support.
• Require Node.js 20.19 or newer and a preinstalled claudexor command. If the MCP server is missing, ask the user to run npm install -g claudexor, then restart the host. Do not download a runtime implicitly.
• If a generated Claudexor host integration already owns the current host's setup, leave it in place. Do not repair, replace, or uninstall it automatically.

Choose a route

Start read-only unless the user explicitly asked to change or create files.

1. Call claudexor_status to inspect the aggregate/default-store projection, but do not use it as a universal admission veto. An unpinned request may be admitted by the canonical account pool through a ready exact profile even when default doctor is unavailable; only a genuinely profile-less/default fallback requires doctor status ok and the requested intent. Aggregate status neither proves nor vetoes a pooled or explicitly named profile.
2. Call claudexor_accounts before choosing an account or reviewer identity. It is the read-only Accounts view of registered profiles, readiness, quota freshness, and the daemon's next_up routing projection; the default call combines current quota and registry facts with retained readiness observations. One coalesced cold acquisition, including failure, is followed by passive reads with the original check time; viewing does not renew old evidence. fresh: true requests the atomic snapshot, an expensive explicit refresh to use only when acting on staleness matters. Check the selected row's age: retained available/passed describes its last observation, while actual execution performs its own current admission checks. unknown, not_run, or stale quota means uncertain, not absent. Never substitute aggregate doctor status, another profile's probe, or a host/default login. Never initiate login or OAuth merely because a row is unknown; ask the user for explicit authority. An explicit reviewer credentialProfileId is strict and never falls back, while an omitted id uses the canonical account pool.
3. Call claudexor_capabilities when the task depends on the current modes, mutability, controls, models, setup transport, or tool surface. The CLI claudexor models --harness <id> is default-route discovery, not a named profile's entitlement; source: none or an unavailable inventory is an honest refusal, not permission to guess. For a named profile, let the strict pinned run/reviewer preflight admit the model and verify observed profile/model telemetry afterward. A declared setupLogin transport of external_terminal means the host must provide the supported client terminal attach path; it is not itself unreadiness and must not be silently treated as in_app.
4. Use claudexor_ask for read-only answers and bounded research, or claudexor_plan for a read-only implementation plan.
5. Only for explicit implementation intent, use claudexor_run, claudexor_best_of, or claudexor_create. Pass an absolute repoPath whenever the target repository could be ambiguous. Pass credentialProfileId to pin the run strictly to one account.
6. For durable multi-turn work, call claudexor_thread_create once and enqueue each follow-up with claudexor_thread_turn. Pass an idempotencyKey and retry an unknown outcome with the same key and body. Follow the returned runId with the same status/result tools as a one-shot run; if only a queued jobId is returned, use claudexor_runs to recover its runId after binding. claudexor_thread_read lists earlier turns without starting work.