@vibeshiphq/cli 0.1.0 → 0.2.1

package/README.md

@@ -1,16 +1,16 @@
 # VibeShip CLI
 
-Public CLI for initializing the private VibeShip starter and installing VibeShip Pilot for guided setup.
+Public CLI for initializing the private VibeShip starter and installing VibeShip Hyperdrive for guided setup.
 
 ```bash
 npm install -g @vibeshiphq/cli
 vibeship login
 vibeship init my-app
 cd my-app
-vibeship pilot install
+vibeship hyperdrive install
 ```
 
-The CLI does not embed proprietary setup runbooks. It authenticates the user, checks starter/Pilot entitlement through VibeShip, clones the private starter, and writes local Codex MCP config for Pilot.
+The CLI does not embed proprietary setup runbooks. It authenticates the user, checks starter/Hyperdrive entitlement through VibeShip, clones the private starter, and writes local Codex MCP config for Hyperdrive.
 
 ## Commands
 
@@ -18,15 +18,20 @@ The CLI does not embed proprietary setup runbooks. It authenticates the user, ch
 vibeship login                    # Authenticate this machine with VibeShip
 vibeship logout                   # Remove local CLI auth
 vibeship whoami                   # Show account and entitlement status
-vibeship doctor                   # Inspect auth, project, and Pilot config
+vibeship doctor                   # Inspect auth, project, and Hyperdrive config
 vibeship init [targetDir]         # Clone the private starter into a new app
-vibeship pilot install            # Install Pilot MCP config into .codex/config.toml
-vibeship pilot status             # Show Pilot subscription and project config status
+vibeship hyperdrive install   # Install Hyperdrive MCP config into .codex/config.toml
+vibeship hyperdrive status    # Show Hyperdrive subscription, config, and MCP reachability
 ```
 
 Configuration is stored at `~/.vibeship/config.json`. The default production API is `https://www.vibeship.today`; override it with `VIBESHIP_API_URL` or `--api-url` when dogfooding against a local internal app.
 
-Pilot MCP defaults to `https://pilot.vibeship.today/mcp`; override it with `VIBESHIP_PILOT_MCP_URL` or `--mcp-url`.
+Hyperdrive MCP defaults to `https://hyperdrive.vibeship.today/mcp`; override it with
+`VIBESHIP_HYPERDRIVE_MCP_URL` or `--mcp-url`. `vibeship hyperdrive status` calls Hyperdrive's
+`vibeship_hyperdrive_status` MCP tool with your stored CLI token and reports whether
+the server accepted the token.
+
+`vibeship init` checks your VibeShip entitlement first, then tries to clone the private starter over SSH and falls back to HTTPS. If GitHub access fails after entitlement approval, connect the Polar GitHub repository access benefit in the VibeShip customer portal, verify access to `vibeshiphq/vibeship-starter`, and rerun `vibeship init`. Support can provide `--repo-url` or `VIBESHIP_STARTER_REPO_URL` for temporary clone overrides.
 
 ## Development
 

package/dist/api.d.ts

@@ -1,11 +1,36 @@
 import type { AuthState } from "./config.js";
+import { z } from "zod";
 export type EntitlementStatus = {
     email?: string;
     starterAccess: boolean;
-    pilotActive: boolean;
+    hyperdriveActive: boolean;
     entitlements: string[];
 };
+declare const hyperdriveMcpStatusSchema: z.ZodObject<{
+    authenticated: z.ZodBoolean;
+    subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    entitlements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tokenExpiresAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    subscriptionStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    server: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        protocolVersion: z.ZodString;
+        authority: z.ZodString;
+    }, z.core.$loose>;
+    providers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    rateLimit: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+}, z.core.$loose>;
+export type HyperdriveMcpStatus = z.infer<typeof hyperdriveMcpStatusSchema>;
 export declare function fetchEntitlements({ apiUrl, auth, }: {
     apiUrl: string;
     auth: AuthState;
 }): Promise<EntitlementStatus>;
+export declare function fetchHyperdriveMcpStatus({ mcpUrl, auth, fetchImpl, }: {
+    mcpUrl: string;
+    auth: AuthState;
+    fetchImpl?: typeof fetch;
+}): Promise<HyperdriveMcpStatus>;
+export {};

package/dist/api.js

@@ -1,10 +1,32 @@
+import { z } from "zod";
+const hyperdriveMcpStatusSchema = z
+    .object({
+    authenticated: z.boolean(),
+    subject: z.string().nullable().optional(),
+    email: z.string().nullable().optional(),
+    reason: z.string().nullable().optional(),
+    entitlements: z.array(z.string()).default([]),
+    tokenExpiresAt: z.string().nullable().optional(),
+    subscriptionStatus: z.string().nullable().optional(),
+    server: z
+        .object({
+        name: z.string(),
+        version: z.string(),
+        protocolVersion: z.string(),
+        authority: z.string(),
+    })
+        .passthrough(),
+    providers: z.array(z.string()).default([]),
+    rateLimit: z.unknown().nullable().optional(),
+})
+    .passthrough();
 export async function fetchEntitlements({ apiUrl, auth, }) {
     if (process.env.VIBESHIP_CLI_OFFLINE === "1") {
         return {
             email: auth.email,
             starterAccess: true,
-            pilotActive: true,
-            entitlements: ["license:starter", "pilot:active"],
+            hyperdriveActive: true,
+            entitlements: ["license:starter", "hyperdrive:active"],
         };
     }
     const url = new URL("/api/cli/entitlements", apiUrl);
@@ -28,6 +50,61 @@ export async function fetchEntitlements({ apiUrl, auth, }) {
     }
     return (await response.json());
 }
+export async function fetchHyperdriveMcpStatus({ mcpUrl, auth, fetchImpl = fetch, }) {
+    const url = new URL(mcpUrl);
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method: "POST",
+            headers: {
+                authorization: `Bearer ${auth.token}`,
+                "content-type": "application/json",
+                accept: "application/json",
+            },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: "vibeship-cli-status",
+                method: "tools/call",
+                params: {
+                    name: "vibeship_hyperdrive_status",
+                    arguments: {},
+                },
+            }),
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not reach Hyperdrive MCP at ${url.origin}: ${message}`);
+    }
+    if (!response.ok) {
+        throw new Error(`Hyperdrive MCP check failed with HTTP ${response.status}${await responseSuffix(response)}.`);
+    }
+    const body = (await response.json());
+    if (body.error) {
+        const message = typeof body.error.message === "string"
+            ? body.error.message
+            : "JSON-RPC error";
+        throw new Error(`Hyperdrive MCP check failed: ${message}`);
+    }
+    const status = body.result?.structuredContent ??
+        parseTextContent(body.result?.content?.find((item) => item.type === "text"));
+    const parsed = hyperdriveMcpStatusSchema.safeParse(status);
+    if (!parsed.success) {
+        throw new Error("Hyperdrive MCP status response was not recognized.");
+    }
+    return parsed.data;
+}
+function parseTextContent(item) {
+    if (typeof item?.text !== "string") {
+        return null;
+    }
+    try {
+        return JSON.parse(item.text);
+    }
+    catch {
+        return null;
+    }
+}
 async function responseSuffix(response) {
     const text = (await response.text()).trim();
     if (!text) {

package/dist/codex.d.ts

@@ -1,8 +1,8 @@
 export declare function projectCodexConfigPath(projectDir: string): string;
-export declare function pilotCodexConfig({ mcpUrl, }: {
+export declare function hyperdriveCodexConfig({ mcpUrl, }: {
     mcpUrl: string;
 }): string;
-export declare function installPilotCodexConfig({ projectDir, mcpUrl, }: {
+export declare function installHyperdriveCodexConfig({ projectDir, mcpUrl, }: {
     projectDir: string;
     mcpUrl: string;
 }): string;

package/dist/codex.js

@@ -3,21 +3,21 @@ import path from "node:path";
 export function projectCodexConfigPath(projectDir) {
     return path.join(projectDir, ".codex", "config.toml");
 }
-export function pilotCodexConfig({ mcpUrl, }) {
-    return `[mcp_servers.vibeship-pilot]
+export function hyperdriveCodexConfig({ mcpUrl, }) {
+    return `[mcp_servers.vibeship-hyperdrive]
 url = "${mcpUrl}"
-bearer_token_env_var = "VIBESHIP_PILOT_TOKEN"
+bearer_token_env_var = "VIBESHIP_HYPERDRIVE_TOKEN"
 default_tools_approval_mode = "prompt"
 `;
 }
-export function installPilotCodexConfig({ projectDir, mcpUrl, }) {
+export function installHyperdriveCodexConfig({ projectDir, mcpUrl, }) {
     const file = projectCodexConfigPath(projectDir);
     fs.mkdirSync(path.dirname(file), { recursive: true });
     const existing = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : "";
-    const marker = "[mcp_servers.vibeship-pilot]";
+    const marker = "[mcp_servers.vibeship-hyperdrive]";
     const next = existing.includes(marker)
-        ? existing.replace(/\[mcp_servers\.vibeship-pilot\][\s\S]*?(?=\n\[|$)/, pilotCodexConfig({ mcpUrl }).trimEnd())
-        : `${existing.trimEnd()}${existing.trim() ? "\n\n" : ""}${pilotCodexConfig({
+        ? existing.replace(/\[mcp_servers\.vibeship-hyperdrive\][\s\S]*?(?=\n\[|$)/, hyperdriveCodexConfig({ mcpUrl }).trimEnd())
+        : `${existing.trimEnd()}${existing.trim() ? "\n\n" : ""}${hyperdriveCodexConfig({
             mcpUrl,
         }).trimEnd()}\n`;
     fs.writeFileSync(file, next);

package/dist/config.d.ts

@@ -9,7 +9,7 @@ export type AuthState = z.infer<typeof authStateSchema>;
 export type CliConfig = {
     auth?: AuthState;
     apiUrl?: string;
-    pilotMcpUrl?: string;
+    hyperdriveMcpUrl?: string;
 };
 export declare function configDir(): string;
 export declare function configPath(): string;
@@ -18,5 +18,5 @@ export declare function writeConfig(config: CliConfig): void;
 export declare function clearAuth(): void;
 export declare function requireAuth(config?: CliConfig): AuthState;
 export declare function defaultApiUrl(): string;
-export declare function defaultPilotMcpUrl(): string;
+export declare function defaultHyperdriveMcpUrl(): string;
 export {};

package/dist/config.js

@@ -11,7 +11,7 @@ const authStateSchema = z.object({
 const configSchema = z.object({
     auth: authStateSchema.optional(),
     apiUrl: z.string().url().optional(),
-    pilotMcpUrl: z.string().url().optional(),
+    hyperdriveMcpUrl: z.string().url().optional(),
 });
 export function configDir() {
     return path.join(os.homedir(), ".vibeship");
@@ -52,6 +52,6 @@ export function defaultApiUrl() {
     }
     return "https://www.vibeship.today";
 }
-export function defaultPilotMcpUrl() {
-    return process.env.VIBESHIP_PILOT_MCP_URL ?? "https://pilot.vibeship.today/mcp";
+export function defaultHyperdriveMcpUrl() {
+    return process.env.VIBESHIP_HYPERDRIVE_MCP_URL ?? "https://hyperdrive.vibeship.today/mcp";
 }

package/dist/index.js

@@ -16,9 +16,9 @@ function recoveryActions(message) {
             "Then run vibeship login again.",
         ];
     }
-    if (message.includes("Pilot subscription")) {
+    if (message.includes("Hyperdrive subscription")) {
         return [
-            "Confirm this account has an active Pilot subscription at https://www.vibeship.today.",
+            "Confirm this account has an active Hyperdrive subscription at https://www.vibeship.today.",
             "Then run vibeship login again.",
         ];
     }
@@ -34,5 +34,12 @@ function recoveryActions(message) {
     if (message.includes("already exists and is not empty")) {
         return ["Choose a new directory: vibeship init my-app"];
     }
+    if (message.includes("Could not clone the VibeShip starter")) {
+        return [
+            "Confirm the Polar GitHub repository access benefit is connected to your GitHub account.",
+            "Check SSH with `ssh -T git@github.com` or HTTPS auth with `gh auth status`.",
+            "Use --repo-url or VIBESHIP_STARTER_REPO_URL if support gave you a temporary clone URL.",
+        ];
+    }
     return ["Run with --help to inspect command options."];
 }

package/dist/program.d.ts

@@ -1,2 +1,23 @@
+import { type SetupConfig } from "./project-config.js";
+type CloneSource = {
+    label: string;
+    url: string;
+};
+type CloneFailure = CloneSource & {
+    message: string;
+};
+export declare function starterCloneSources(overrideUrl?: string): CloneSource[];
+export declare function starterCloneRecoveryActions(failures: CloneFailure[]): string[];
+export declare function shouldPromptForSetup(options: {
+    workflow?: string;
+    integrations?: string;
+    interactive?: boolean;
+}): boolean;
+export declare function resolveInitSetupConfig(options: {
+    workflow?: string;
+    integrations?: string;
+    interactive?: boolean;
+}): Promise<SetupConfig>;
 export declare function run(argv: string[]): Promise<void>;
 export declare function normalizeArgv(argv: string[]): string[];
+export {};

package/dist/program.js

@@ -1,14 +1,46 @@
 import fs from "node:fs";
 import path from "node:path";
+import readline from "node:readline/promises";
 import { Command } from "commander";
 import { execa } from "execa";
 import open from "open";
-import { fetchEntitlements } from "./api.js";
-import { clearAuth, defaultApiUrl, defaultPilotMcpUrl, readConfig, requireAuth, writeConfig, } from "./config.js";
-import { installPilotCodexConfig } from "./codex.js";
+import { fetchEntitlements, fetchHyperdriveMcpStatus } from "./api.js";
+import { clearAuth, defaultApiUrl, defaultHyperdriveMcpUrl, readConfig, requireAuth, writeConfig, } from "./config.js";
+import { installHyperdriveCodexConfig } from "./codex.js";
 import { startBrowserLogin } from "./login.js";
+import { parseIntegrations, parseWorkflow, setupConfigForWorkflow, setupIntegrations, writeProjectSetupConfig, } from "./project-config.js";
 import { line, renderDone, renderInfo } from "./ui.js";
-const STARTER_REPO = "git@github.com:vibeshiphq/vibeship-starter.git";
+const STARTER_REPO_SSH = "git@github.com:vibeshiphq/vibeship-starter.git";
+const STARTER_REPO_HTTPS = "https://github.com/vibeshiphq/vibeship-starter.git";
+export function starterCloneSources(overrideUrl) {
+    const configured = overrideUrl ?? process.env.VIBESHIP_STARTER_REPO_URL?.trim();
+    if (configured) {
+        return [{ label: "custom", url: configured }];
+    }
+    return [
+        { label: "ssh", url: STARTER_REPO_SSH },
+        { label: "https", url: STARTER_REPO_HTTPS },
+    ];
+}
+function cloneErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+export function starterCloneRecoveryActions(failures) {
+    const attempted = failures
+        .map((failure) => `${failure.label}: ${failure.url}`)
+        .join("; ");
+    return [
+        `Clone attempts failed (${attempted}).`,
+        "Open the Polar customer portal from VibeShip and confirm the GitHub repository access benefit is connected to the right GitHub account.",
+        "Confirm that account can access vibeshiphq/vibeship-starter in GitHub.",
+        "For SSH, run `ssh -T git@github.com` and confirm your key is accepted.",
+        "For HTTPS, run `gh auth status` or sign in to GitHub in your credential manager.",
+        "If access was just granted, wait a minute and rerun `vibeship init`.",
+    ];
+}
 async function commandLogin(options) {
     const config = readConfig();
     const apiUrl = options.apiUrl ?? config.apiUrl ?? defaultApiUrl();
@@ -67,7 +99,7 @@ async function commandWhoami(options = {}) {
         line("email", status.email ?? auth.email ?? "unknown"),
         line("api", apiUrl, "muted"),
         line("starter", status.starterAccess ? "ready" : "missing", status.starterAccess ? "success" : "warning"),
-        line("pilot", status.pilotActive ? "active" : "inactive", status.pilotActive ? "success" : "warning"),
+        line("hyperdrive", status.hyperdriveActive ? "active" : "inactive", status.hyperdriveActive ? "success" : "warning"),
     ]);
 }
 async function commandDoctor(options) {
@@ -77,15 +109,15 @@ async function commandDoctor(options) {
     const codexConfig = path.join(projectDir, ".codex", "config.toml");
     const hasAuth = Boolean(config.auth?.token);
     const hasProject = fs.existsSync(marker);
-    const hasPilotConfig = fs.existsSync(codexConfig);
+    const hasHyperdriveConfig = fs.existsSync(codexConfig);
     renderInfo("Doctor", [
         line("auth", hasAuth ? "present" : "missing", hasAuth ? "success" : "warning"),
         line("api", options.apiUrl ?? config.apiUrl ?? defaultApiUrl(), "muted"),
         line("project", hasProject ? "vibeship starter" : "not detected", hasProject ? "success" : "warning"),
-        line("pilot config", hasPilotConfig ? codexConfig : "not installed", hasPilotConfig ? "success" : "warning"),
-    ], doctorActions({ hasAuth, hasProject, hasPilotConfig, projectDir }));
+        line("hyperdrive config", hasHyperdriveConfig ? codexConfig : "not installed", hasHyperdriveConfig ? "success" : "warning"),
+    ], doctorActions({ hasAuth, hasProject, hasHyperdriveConfig, projectDir }));
 }
-async function cloneStarter({ targetDir, localStarter, }) {
+async function cloneStarter({ targetDir, localStarter, repoUrl, }) {
     if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
         throw new Error(`${targetDir} already exists and is not empty.`);
     }
@@ -93,7 +125,66 @@ async function cloneStarter({ targetDir, localStarter, }) {
         await execa("cp", ["-R", `${path.resolve(localStarter)}/.`, targetDir]);
         return;
     }
-    await execa("git", ["clone", STARTER_REPO, targetDir]);
+    const failures = [];
+    for (const source of starterCloneSources(repoUrl)) {
+        try {
+            await execa("git", ["clone", source.url, targetDir]);
+            return;
+        }
+        catch (error) {
+            failures.push({ ...source, message: cloneErrorMessage(error) });
+            fs.rmSync(targetDir, { recursive: true, force: true });
+        }
+    }
+    throw new Error([
+        "Could not clone the VibeShip starter after entitlement approval.",
+        ...starterCloneRecoveryActions(failures),
+        "Raw git errors:",
+        ...failures.map((failure) => `- ${failure.label}: ${failure.message.slice(0, 500)}`),
+    ].join("\n"));
+}
+export function shouldPromptForSetup(options) {
+    if (options.interactive === false) {
+        return false;
+    }
+    return (!options.workflow &&
+        !options.integrations &&
+        Boolean(process.stdin.isTTY && process.stdout.isTTY));
+}
+function parseIntegrationAnswer(answer) {
+    return parseIntegrations(answer.trim() || undefined);
+}
+async function promptForSetupConfig() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const workflowAnswer = await rl.question("Setup workflow [1 local-first, 2 launch-ready] (1): ");
+        const workflow = workflowAnswer.trim() === "2" || workflowAnswer.trim() === "launch-ready"
+            ? "launch-ready"
+            : "local-first";
+        const defaultList = setupIntegrations
+            .filter((integration) => ["clerk", "convex", "polar", "resend", "vercel"].includes(integration))
+            .join(",");
+        const integrationsAnswer = await rl.question(`Enabled integrations (${defaultList}): `);
+        return setupConfigForWorkflow({
+            workflow,
+            integrations: parseIntegrationAnswer(integrationsAnswer) ?? undefined,
+        });
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function resolveInitSetupConfig(options) {
+    if (shouldPromptForSetup(options)) {
+        return promptForSetupConfig();
+    }
+    return setupConfigForWorkflow({
+        workflow: parseWorkflow(options.workflow),
+        integrations: parseIntegrations(options.integrations),
+    });
 }
 async function commandInit(options) {
     const config = readConfig();
@@ -107,18 +198,33 @@ async function commandInit(options) {
         throw new Error("This account does not have VibeShip starter access.");
     }
     const targetDir = path.resolve(options.dir ?? options.targetDir ?? "vibeship-app");
+    const setup = await resolveInitSetupConfig({
+        workflow: options.workflow,
+        integrations: options.integrations,
+    });
     renderInfo("Initializing starter", [
         line("directory", targetDir),
-        line("source", options.localStarter ? path.resolve(options.localStarter) : STARTER_REPO),
+        line("source", options.localStarter
+            ? path.resolve(options.localStarter)
+            : starterCloneSources(options.repoUrl)
+                .map((source) => source.url)
+                .join(" then ")),
         line("install", options.skipInstall ? "skipped" : "pnpm install"),
+        line("workflow", setup.workflow),
+        line("environments", setup.environments.join(", ")),
     ]);
-    await cloneStarter({ targetDir, localStarter: options.localStarter });
+    await cloneStarter({
+        targetDir,
+        localStarter: options.localStarter,
+        repoUrl: options.repoUrl,
+    });
+    writeProjectSetupConfig({ projectDir: targetDir, setup });
     if (!options.skipInstall) {
         await execa("pnpm", ["install"], { cwd: targetDir, stdio: "inherit" });
     }
-    renderDone("Starter initialized", [line("directory", targetDir)], [`cd ${targetDir}`, "vibeship pilot install"]);
+    renderDone("Starter initialized", [line("directory", targetDir)], [`cd ${targetDir}`, "vibeship hyperdrive install"]);
 }
-async function commandPilotInstall(options) {
+async function commandHyperdriveInstall(options) {
     const config = readConfig();
     const auth = requireAuth(config);
     const apiUrl = options.apiUrl ?? config.apiUrl ?? defaultApiUrl();
@@ -126,22 +232,22 @@ async function commandPilotInstall(options) {
         apiUrl,
         auth,
     });
-    if (!status.pilotActive) {
-        throw new Error("This account does not have an active VibeShip Pilot subscription.");
+    if (!status.hyperdriveActive) {
+        throw new Error("This account does not have an active VibeShip Hyperdrive subscription.");
     }
     const projectDir = path.resolve(options.projectDir ?? process.cwd());
-    const mcpUrl = options.mcpUrl ?? config.pilotMcpUrl ?? defaultPilotMcpUrl();
-    const file = installPilotCodexConfig({ projectDir, mcpUrl });
-    renderDone("Pilot installed", [
+    const mcpUrl = options.mcpUrl ?? config.hyperdriveMcpUrl ?? defaultHyperdriveMcpUrl();
+    const file = installHyperdriveCodexConfig({ projectDir, mcpUrl });
+    renderDone("Hyperdrive installed", [
         line("project", projectDir),
         line("config", file),
         line("mcp", mcpUrl),
     ], [
-        "export VIBESHIP_PILOT_TOKEN=$(vibeship whoami --token-only)",
-        "Open Codex in this project and use VibeShip Pilot.",
+        "export VIBESHIP_HYPERDRIVE_TOKEN=$(vibeship whoami --token-only)",
+        "Open Codex in this project and use VibeShip Hyperdrive.",
     ]);
 }
-async function commandPilotStatus(options) {
+async function commandHyperdriveStatus(options) {
     const config = readConfig();
     const auth = requireAuth(config);
     const apiUrl = options.apiUrl ?? config.apiUrl ?? defaultApiUrl();
@@ -151,19 +257,32 @@ async function commandPilotStatus(options) {
     });
     const projectDir = path.resolve(options.projectDir ?? process.cwd());
     const codexConfig = path.join(projectDir, ".codex", "config.toml");
-    const hasPilotConfig = fs.existsSync(codexConfig);
-    renderDone("Pilot status", [
-        line("subscription", status.pilotActive ? "active" : "inactive", status.pilotActive ? "success" : "warning"),
+    const hasHyperdriveConfig = fs.existsSync(codexConfig);
+    const mcpUrl = options.mcpUrl ?? config.hyperdriveMcpUrl ?? defaultHyperdriveMcpUrl();
+    const details = [
+        line("subscription", status.hyperdriveActive ? "active" : "inactive", status.hyperdriveActive ? "success" : "warning"),
         line("project", projectDir),
-        line("config", hasPilotConfig ? codexConfig : "missing", hasPilotConfig ? "success" : "warning"),
-    ]);
+        line("config", hasHyperdriveConfig ? codexConfig : "missing", hasHyperdriveConfig ? "success" : "warning"),
+        line("mcp", mcpUrl, "muted"),
+    ];
+    try {
+        const hyperdriveStatus = await fetchHyperdriveMcpStatus({ mcpUrl, auth });
+        details.push(line("mcp auth", hyperdriveStatus.authenticated
+            ? "accepted"
+            : `rejected: ${hyperdriveStatus.reason ?? "unknown"}`, hyperdriveStatus.authenticated ? "success" : "warning"), line("server", `${hyperdriveStatus.server.name}@${hyperdriveStatus.server.version}`, "muted"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        details.push(line("mcp check", message.slice(0, 140), "warning"));
+    }
+    renderDone("Hyperdrive status", details);
 }
 export async function run(argv) {
     const program = new Command();
     program
         .name("vibeship")
-        .description("Initialize VibeShip starter apps and install VibeShip Pilot.")
-        .version("0.1.0")
+        .description("Initialize VibeShip starter apps and install VibeShip Hyperdrive.")
+        .version("0.2.1")
         .showHelpAfterError()
         .showSuggestionAfterError()
         .configureHelp({ sortSubcommands: true })
@@ -171,12 +290,14 @@ export async function run(argv) {
 Examples:
   $ vibeship login
   $ vibeship init my-app
-  $ vibeship pilot install --project-dir ./my-app
+  $ vibeship init my-app --workflow local-first --integrations clerk,convex,polar,resend,vercel
+  $ vibeship hyperdrive install --project-dir ./my-app
   $ vibeship doctor
 
 Environment:
   VIBESHIP_API_URL            Override the VibeShip API URL.
-  VIBESHIP_PILOT_MCP_URL      Override the Pilot MCP URL.
+  VIBESHIP_HYPERDRIVE_MCP_URL      Override the Hyperdrive MCP URL.
+  VIBESHIP_STARTER_REPO_URL   Override the starter repository clone URL.
   VIBESHIP_CLI_OFFLINE=1      Use local entitlement fixtures for development.
 `);
     program
@@ -204,7 +325,7 @@ Environment:
     });
     program
         .command("doctor")
-        .description("Inspect auth, project, and Pilot config for this directory.")
+        .description("Inspect auth, project, and Hyperdrive config for this directory.")
         .option("--project-dir <dir>", "Project directory", process.cwd())
         .option("--api-url <url>", "VibeShip API URL")
         .action(commandDoctor);
@@ -213,23 +334,27 @@ Environment:
         .description("Clone the private starter into a new app directory.")
         .option("--dir <dir>", "Target directory")
         .option("--local-starter <dir>", "Use a local starter checkout")
+        .option("--repo-url <url>", "Override the starter repository clone URL")
         .option("--skip-install", "Skip pnpm install")
         .option("--api-url <url>", "VibeShip API URL")
+        .option("--workflow <workflow>", "Setup workflow: local-first or launch-ready")
+        .option("--integrations <list>", "Comma-separated setup integrations to enable")
         .action((targetDir, options) => commandInit({ ...options, targetDir }));
-    const pilot = program.command("pilot").description("Manage VibeShip Pilot setup.");
-    pilot
+    const hyperdrive = program.command("hyperdrive").description("Manage VibeShip Hyperdrive setup.");
+    hyperdrive
         .command("install")
-        .description("Install Pilot MCP config into a Codex project.")
+        .description("Install Hyperdrive MCP config into a Codex project.")
         .option("--project-dir <dir>", "Project directory", process.cwd())
-        .option("--mcp-url <url>", "Pilot MCP URL")
+        .option("--mcp-url <url>", "Hyperdrive MCP URL")
         .option("--api-url <url>", "VibeShip API URL")
-        .action(commandPilotInstall);
-    pilot
+        .action(commandHyperdriveInstall);
+    hyperdrive
         .command("status")
-        .description("Show Pilot subscription and project config status.")
+        .description("Show Hyperdrive subscription and project config status.")
         .option("--project-dir <dir>", "Project directory", process.cwd())
         .option("--api-url <url>", "VibeShip API URL")
-        .action(commandPilotStatus);
+        .option("--mcp-url <url>", "Hyperdrive MCP URL")
+        .action(commandHyperdriveStatus);
     await program.parseAsync(normalizeArgv(argv));
 }
 export function normalizeArgv(argv) {
@@ -239,7 +364,7 @@ export function normalizeArgv(argv) {
     }
     return argv;
 }
-function doctorActions({ hasAuth, hasProject, hasPilotConfig, projectDir, }) {
+function doctorActions({ hasAuth, hasProject, hasHyperdriveConfig, projectDir, }) {
     const actions = [];
     if (!hasAuth) {
         actions.push("vibeship login");
@@ -247,10 +372,10 @@ function doctorActions({ hasAuth, hasProject, hasPilotConfig, projectDir, }) {
     if (!hasProject) {
         actions.push("Run from a starter app, or create one with vibeship init my-app.");
     }
-    if (!hasPilotConfig) {
+    if (!hasHyperdriveConfig) {
         actions.push(projectDir === process.cwd()
-            ? "vibeship pilot install"
-            : `vibeship pilot install --project-dir ${projectDir}`);
+            ? "vibeship hyperdrive install"
+            : `vibeship hyperdrive install --project-dir ${projectDir}`);
     }
     return actions;
 }

package/dist/project-config.d.ts

@@ -0,0 +1,31 @@
+export declare const setupWorkflows: readonly ["local-first", "launch-ready"];
+export declare const setupEnvironments: readonly ["development", "preview", "production"];
+export declare const setupIntegrations: readonly ["clerk", "convex", "polar", "resend", "posthog", "vercel", "calCom"];
+export type SetupWorkflow = (typeof setupWorkflows)[number];
+export type SetupEnvironment = (typeof setupEnvironments)[number];
+export type SetupIntegration = (typeof setupIntegrations)[number];
+export type SetupConfig = {
+    workflow: SetupWorkflow;
+    environments: SetupEnvironment[];
+    integrations: Record<SetupIntegration, boolean>;
+};
+export declare function defaultIntegrations(): {
+    clerk: true;
+    convex: true;
+    polar: true;
+    resend: true;
+    posthog: false;
+    vercel: true;
+    calCom: false;
+};
+export declare function environmentsForWorkflow(workflow: SetupWorkflow): SetupEnvironment[];
+export declare function setupConfigForWorkflow({ workflow, integrations, }: {
+    workflow: SetupWorkflow;
+    integrations?: SetupIntegration[];
+}): SetupConfig;
+export declare function parseWorkflow(value: string | undefined): SetupWorkflow;
+export declare function parseIntegrations(value: string | undefined): ("clerk" | "convex" | "polar" | "resend" | "posthog" | "vercel" | "calCom")[] | undefined;
+export declare function writeProjectSetupConfig({ projectDir, setup, }: {
+    projectDir: string;
+    setup: SetupConfig;
+}): void;

package/dist/project-config.js

@@ -0,0 +1,75 @@
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+export const setupWorkflows = ["local-first", "launch-ready"];
+export const setupEnvironments = [
+    "development",
+    "preview",
+    "production",
+];
+export const setupIntegrations = [
+    "clerk",
+    "convex",
+    "polar",
+    "resend",
+    "posthog",
+    "vercel",
+    "calCom",
+];
+const workflowSchema = z.enum(setupWorkflows);
+const integrationsSchema = z
+    .array(z.enum(setupIntegrations))
+    .min(1, "Select at least one integration.");
+export function defaultIntegrations() {
+    return {
+        clerk: true,
+        convex: true,
+        polar: true,
+        resend: true,
+        posthog: false,
+        vercel: true,
+        calCom: false,
+    };
+}
+export function environmentsForWorkflow(workflow) {
+    return workflow === "local-first"
+        ? ["development"]
+        : ["development", "preview", "production"];
+}
+export function setupConfigForWorkflow({ workflow, integrations, }) {
+    const enabled = {
+        ...defaultIntegrations(),
+    };
+    if (integrations) {
+        for (const integration of setupIntegrations) {
+            enabled[integration] = integrations.includes(integration);
+        }
+    }
+    return {
+        workflow,
+        environments: environmentsForWorkflow(workflow),
+        integrations: enabled,
+    };
+}
+export function parseWorkflow(value) {
+    return workflowSchema.parse(value ?? "local-first");
+}
+export function parseIntegrations(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    return integrationsSchema.parse(parsed);
+}
+export function writeProjectSetupConfig({ projectDir, setup, }) {
+    const vibeshipDir = path.join(projectDir, ".vibeship");
+    const marker = path.join(vibeshipDir, "project.json");
+    const existing = fs.existsSync(marker)
+        ? JSON.parse(fs.readFileSync(marker, "utf8"))
+        : {};
+    fs.mkdirSync(vibeshipDir, { recursive: true });
+    fs.writeFileSync(marker, `${JSON.stringify({ ...existing, setup }, null, 2)}\n`);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vibeshiphq/cli",
-  "version": "0.1.0",
-  "description": "VibeShip CLI for starter initialization and Pilot setup.",
+  "version": "0.2.1",
+  "description": "VibeShip CLI for starter initialization and Hyperdrive setup.",
   "type": "module",
   "license": "UNLICENSED",
   "homepage": "https://www.vibeship.today",