Function runSetup

packages/cli/src/commands/setup-pi.ts:226–390

(options: RunSetupOptions = {})

}

export async function runSetup(options: RunSetupOptions = {}): Promise<number> {
    const prompts = options.prompts ?? (await getDefaultPrompts());
    const env = options.env ?? DEFAULT_ENV;
    const dryRun = options.dryRun === true;

    prompts.intro("Magic Context for Pi — Setup");
    if (dryRun) {
        prompts.log.warn("Dry run — no files will be written and no package will be registered.");
        prompts.log.message(
            "[dry-run] would migrate legacy Magic Context config before setup reads or writes the shared CortexKit config.",
        );
    } else {
        const migrationWarnings = migrateConfigLocationsForCli(process.cwd(), prompts.log);
        if (hasUserConfigLocationMigrationRefusal(migrationWarnings)) {
            prompts.outro(
                "Setup stopped — resolve the legacy Magic Context user config migration conflict, then rerun setup.",
            );
            return 1;
        }
    }

    const spinner = prompts.spinner();
    spinner.start("Checking Pi installation");
    const pi = env.detectPiBinary();
    if (!pi) {
        spinner.stop("Pi not found");
        prompts.log.warn("Could not find `pi` on PATH or at ~/.pi/bin/pi.");
        prompts.log.message(
            "Install Pi first, then rerun setup. If Pi is installed in a custom location, add it to PATH.",
        );
        prompts.outro("Setup skipped");
        return 0;
    }

    const version = env.getPiVersion(pi.path);
    spinner.stop(version ? `Pi ${version} detected at ${pi.path}` : `Pi detected at ${pi.path}`);

    // Pi 0.74.0 moved to the `@earendil-works/pi-coding-agent` package scope.
    // Magic Context's peerDependency targets that scope, so older Pi versions
    // (on `@mariozechner/pi-coding-agent`) cannot load this extension.
    const MIN_PI_VERSION = "0.74.0";
    if (version && comparePiVersion(version, MIN_PI_VERSION) < 0) {
        prompts.log.warn(
            `Pi ${version} is older than the required ${MIN_PI_VERSION}.\n` +
                `Pi 0.74.0 renamed the npm package from \`@mariozechner/pi-coding-agent\` ` +
                `to \`@earendil-works/pi-coding-agent\`. Magic Context's peer dependency ` +
                `targets the new scope, so older Pi installs cannot load this extension.\n` +
                `Run \`pi update --self\` (or \`npm install -g @earendil-works/pi-coding-agent@latest\`) before continuing.`,
        );
        const proceed = await prompts.confirm(
            "Continue with setup anyway? (subagents will fail at runtime)",
            false,
        );
        if (!proceed) {
            prompts.outro("Setup cancelled — upgrade Pi and try again.");
            return 0;
        }
    }