ModelHub Kit

Lightweight maintenance for coding CLIs, model catalogs, and native MCP/ACP configuration across Linux, macOS, and Windows. Python 3.11+, standard library, no runtime dependencies.

Install

Download or clone this repository, inspect it, and run:

sh scripts/install.sh

Windows PowerShell:

& .\scripts\install.ps1

The installer creates a per-user command and initializes an empty personal configuration outside the checkout. It preserves existing configuration and compatible runtimes. Use --prerequisites on Unix or -Prerequisites on Windows to explicitly install missing prerequisites through a supported native package manager. Missing or obsolete Node runtimes are resolved from the current official LTS release index; an already compatible Node is reused without a same-version reinstall. Unsupported package-manager versions produce an actionable result. Installation instructions cover release selection, paths, prerequisites, PATH setup, initialization, optional scheduling, kit upgrades and removal.

modelhub-kit doctor --json
modelhub-kit update --dry-run
modelhub-kit update --tool codex --install-missing
modelhub-kit schedule --apply

What it does

• Compares official stable versions and updates the owned installation actually used by the selected command. Current versions are left installed, missing tools require an explicit selection, and custom or newer installations are preserved.
• Verifies Codex’s separately running app-server and refreshes a stale one only after its local control RPC proves all loaded turns are idle. A current CLI package can no longer masquerade as a current native model/capability runtime.
• Manages selected npm harnesses and ACP adapters, native Devin CLI, Cursor CLI and Muse Code, plus separate Cursor, Devin and Grok Bot desktop update channels. Product support lists ownership, platform and vendor constraints. Current or newer installations do not trigger an artifact download.
• Serializes mutation with a kernel lock. Active tool sessions defer package replacement. Read-only probes have deadlines; supported vendor installs retain custody of their descendants until natural completion. Unsupported generic mutations queue. Native Droid updates bypass the vendor installer’s process-kill step.
• Refreshes user-selected HTTPS model endpoints with ETag/Last-Modified validators. Invalid/truncated responses retain the last good catalog. Exact model IDs and all supplied reasoning metadata remain intact; unknown capabilities stay unknown.
• Plans native MCP configuration for Codex, Claude Code, OpenCode, Cursor, Qwen Code, Copilot, Devin CLI and Muse Code. Owned entries preserve unrelated settings and use native credential references. Unsupported header interpolation queues for native authentication.