Skip to content

Context7 Platform -- Up-to-date docs for AI agents

CTX7-2681: Clarify CLI login recovery and share the API URL (#3200)

Enes Gules4416fb855b8f
diff --git a/.changeset/clear-login-recovery.md b/.changeset/clear-login-recovery.md
new file mode 100644
index 00000000..81de933a
--- /dev/null
+++ b/.changeset/clear-login-recovery.md
@@ -0,0 +1,7 @@
+---
+"ctx7": patch
+---
+
+Use the shared API URL for login and explain how to sign in again when the server rejects a saved session.
+
+Recommend logout and login only when the server returns HTTP 401. Report other identity-check failures without asking users to discard saved credentials.
diff --git a/packages/cli/src/__tests__/auth-commands.test.ts b/packages/cli/src/__tests__/auth-commands.test.ts
index 7b526edd..dddcd162 100644
--- a/packages/cli/src/__tests__/auth-commands.test.ts
+++ b/packages/cli/src/__tests__/auth-commands.test.ts
@@ -164,18 +164,49 @@ describe("whoami command", () => {
expect(fetchMock).not.toHaveBeenCalled();
});
- test("shows session expired hint when fetch fails", async () => {
+ test("shows logout before login when the server rejects a saved session", async () => {
mockGetValidAccessToken.mockResolvedValue("valid-token");
vi.stubGlobal(
"fetch",
vi.fn().mockResolvedValue({
ok: false,
+ status: 401,
json: () => Promise.reject(new Error("fail")),
})
);
await runCommand("whoami");
- expect(logOutput.some((l) => l.includes("Session may be expired"))).toBe(true);
+ expect(logOutput.join("\n")).toMatch(/ctx7 logout.*ctx7 login/);
+ });
+
+ test.each([403, 500])("does not recommend logout for HTTP %i", async (status) => {
+ mockGetValidAccessToken.mockResolvedValue("valid-token");
+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(new Response(null, { status })));
+
+ await runCommand("whoami");
+
+ expect(logOutput.join("\n")).toContain("Could not verify your session");
+ expect(logOutput.join("\n")).not.toMatch(/ctx7 logout|ctx7 login/);
+ });
+
+ test("does not recommend logout when the identity request fails", async () => {
+ mockGetValidAccessToken.mockResolvedValue("valid-token");
+ vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new TypeError("fetch failed")));
+
+ await runCommand("whoami");
+
+ expect(logOutput.join("\n")).toContain("Could not verify your session");
+ expect(logOutput.join("\n")).not.toMatch(/ctx7 logout|ctx7 login/);
+ });
+
+ test("does not recommend logout for an invalid identity response", async () => {
+ mockGetValidAccessToken.mockResolvedValue("valid-token");
+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(new Response("{")));
+
+ await runCommand("whoami");
+
+ expect(logOutput.join("\n")).toContain("Could not verify your session");
+ expect(logOutput.join("\n")).not.toMatch(/ctx7 logout|ctx7 login/);
});
test("tracks whoami event", async () => {
diff --git a/packages/cli/src/commands/auth.ts b/packages/cli/src/commands/auth.ts
index d1271eb0..948cadd1 100644
--- a/packages/cli/src/commands/auth.ts
+++ b/packages/cli/src/commands/auth.ts
@@ -17,12 +17,6 @@ import { trackEvent } from "../utils/tracking.js";
import { CLI_CLIENT_ID } from "../constants.js";
import { getBaseUrl } from "../utils/api.js";
-let baseUrl = "https://context7.com";
-
-export function setAuthBaseUrl(url: string): void {
- baseUrl = url;
-}
-
export function registerAuthCommands(program: Command): void {
program
.command("login")
@@ -112,6 +106,7 @@ async function announceIdentity(accessToken: string): Promise<string> {
}
export async function performLogin(openBrowser = true): Promise<string | null> {
+ const baseUrl = getBaseUrl();
const spinner = ora("Preparing login...").start();
let authorization;
@@ -246,8 +241,14 @@ async function whoamiCommand(): Promise<void> {
if (whoami.teamspace) {
console.log(`${pc.dim("Teamspace:".padEnd(13))}${whoami.teamspace.name}`);
}
- } catch {
- console.log(pc.dim("(Session may be expired - run 'ctx7 login' to refresh)"));
+ } catch (error) {
+ console.log(
+ pc.dim(
+ error instanceof SessionRejectedError
+ ? "Session was rejected by the server. Run 'ctx7 logout', then 'ctx7 login' to sign in again."
+ : "Could not verify your session. Try again later."
+ )
+ );
}
}
@@ -258,6 +259,8 @@ interface WhoamiResponse {
teamspace: { id: string; name: string } | null;
}
+class SessionRejectedError extends Error {}
+
async function fetchWhoami(accessToken: string): Promise<WhoamiResponse> {
const response = await fetch(`${getBaseUrl()}/api/dashboard/whoami`, {
headers: {
@@ -265,6 +268,9 @@ async function fetchWhoami(accessToken: string): Promise<WhoamiResponse> {
},
});
+ if (response.status === 401) {
+ throw new SessionRejectedError("Session was rejected by the server");
+ }
if (!response.ok) {
throw new Error("Failed to fetch user info");
}
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index ab5339dc..77604871 100644
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -2,7 +2,7 @@ import { Command } from "commander";
import pc from "picocolors";
import figlet from "figlet";
import { registerSkillCommands, registerSkillAliases } from "./commands/skill.js";
-import { registerAuthCommands, setAuthBaseUrl } from "./commands/auth.js";
+import { registerAuthCommands } from "./commands/auth.js";
import { registerSetupCommand } from "./commands/setup.js";
import { registerRemoveCommand } from "./commands/remove.js";
import { registerDocsCommands } from "./commands/docs.js";
@@ -26,7 +26,6 @@ program
const opts = thisCommand.opts();
if (opts.baseUrl) {
setBaseUrl(opts.baseUrl);
- setAuthBaseUrl(opts.baseUrl);
}
})
.hook("preAction", async (_thisCommand, actionCommand) => {