upstash/context7 · warning

Couldn't check for updates right now.

Error message

Couldn't check for updates right now.

What it means

`ctx7 upgrade` calls checkForUpdates({ force: true }) to query the update service. If the call returns null (network failure, timeout, or resolver error), the command warns that it couldn't check for updates, prints the manual upgrade command (plan.displayCommand), and exits without modifying the installation. The local getUpgradePlan() is still used to tell the user how to upgrade manually.

Solutions

1. Follow the printed manual command (e.g. `npm install -g @upstash/context7-mcp@latest` / reinstall via your package manager)
2. Check network connectivity / proxy settings and retry `ctx7 upgrade`
3. Retry later — may be a transient update-server issue
4. Verify no firewall blocks the update endpoint; if behind a proxy, set HTTP(S)_PROXY env vars

Example fix

// before
$ ctx7 upgrade   # fails offline
// after
$ ctx7 upgrade   # after restoring network
# or manually:
$ npm install -g <ctx7-package>@latest

// Probe connectivity before upgrading
const online = await fetch('https://api.github.com', { method: 'HEAD' })
  .then(() => true).catch(() => false);
if (!online) console.log('Offline — upgrade manually: npm install -g <ctx7-package>@latest');

const info = await checkForUpdates({ force: true });
if (info == null || typeof info !== 'object') return; // fall back to manual upgrade command
const hasUpdate: boolean = Boolean((info as any).updateAvailable);

try {
  const info = await checkForUpdates({ force: true });
  if (!info) {
    log.warn("Couldn't check for updates right now.");
    log.info(`Try again later or run ${plan.displayCommand} manually.`);
    return;
  }
} catch (err) {
  log.warn(`Update check failed: ${err}. Install manually instead.`);
}

When it happens

Trigger: Running `ctx7 upgrade` when checkForUpdates returns null/undefined — update-server request failed (offline, DNS failure, proxy blocking, request timeout, or the update endpoint returning an error).

Common situations: No internet connection or corporate proxy/firewall blocking the update endpoint; transient update-server outage; DNS misconfiguration; VPN disconnect mid-check.

Related errors

• Could not reach : )` : ""}\n
• downloadData.error || "no files"
• Failed to fetch user info
• Please try again
• Authentication discovery was redirected. Pass the final…

AI-assisted analysis of upstash/context7@4416fb855b (2026-09-16). Data as JSON: /api/errors/53809d46dffde22f. Report an issue: GitHub.

Appendix: source

Thrown at packages/cli/src/commands/upgrade.ts:130

  }

  log.box([
    `${pc.white(pc.bold("Update available:"))} ${pc.green(pc.bold(`v${info.currentVersion}`))} ${pc.dim("->")} ${pc.green(pc.bold(`v${info.latestVersion}`))}`,
    `${pc.white("Run")} ${pc.yellow(pc.bold("ctx7 upgrade"))} ${pc.white("to update now")}`,
    `${pc.white("Or run")} ${pc.yellow(info.upgradePlan.displayCommand)}`,
  ]);
  await markUpdateNotificationShown(info.latestVersion);
  log.blank();
}

async function upgradeCommand(options: UpgradeOptions): Promise<void> {
  trackEvent("command", { name: "upgrade" });

  const info = await checkForUpdates({ force: true });
  const plan = info?.upgradePlan ?? getUpgradePlan();

  if (!info) {
    log.warn("Couldn't check for updates right now.");
    log.info(`Try again later or run ${pc.cyan(plan.displayCommand)} manually.`);
    return;
  }

  if (!info.updateAvailable) {
    log.success(`ctx7 is up to date (${pc.bold(`v${VERSION}`)})`);
    return;
  }

  log.blank();
  log.info(
    `Update available: ${pc.bold(`v${info.currentVersion}`)} ${pc.dim("->")} ${pc.bold(`v${info.latestVersion}`)}`
  );

  if (plan.needsExplicitVersion) {
    log.info(`You're using an ephemeral runner (${plan.installMethod}).`);
    log.info(`Use ${pc.cyan(plan.displayCommand)} to run the latest version immediately.`);
    log.info(`Or install globally with ${pc.cyan("npm install -g ctx7@latest")}.`);

View on GitHub (pinned to 4416fb855b)