Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import * as Effect from "effect/Effect";
import { HostProcessArguments } from "@akeru/shared/hostProcess";
import packageJson from "../../package.json" with { type: "json" };
export type CliRunner = "npx" | "pnpm dlx" | "bunx";
/**
* How the CLI was launched, judged by where its entry script lives. Each
* package runner executes out of a distinctive cache/temp layout:
*
* npx ~/.npm/_npx/<hash>/node_modules/...
* pnpm dlx ~/.cache/pnpm/dlx/..., $PNPM_HOME/.pnpm/dlx/...,
* or %LOCALAPPDATA%/pnpm-cache/dlx/... on Windows
* bunx ~/.bun/install/cache/... or $TMPDIR/bunx-<uid>-<spec>/...
*
* Global installs and repo checkouts match none of these and return null.
* Detection is best-effort; callers must fail closed to a plain `akeru` command.
*/
export function detectCliRunner(entryPath: string): CliRunner | null {
const path = entryPath.replaceAll("\\", "/");
if (path.includes("/_npx/")) {
return "npx";
}
if (
path.includes("/pnpm/dlx/") ||
path.includes("/.pnpm/dlx/") ||
path.includes("/pnpm-cache/dlx/")
) {
return "pnpm dlx";
}
if (path.includes("/.bun/install/cache/") || path.includes("/bunx-")) {
return "bunx";
}
return null;
}
/**
* The `akeru-bot` package spec to suggest. The literal spec the user typed
* is resolved away before our process starts, so re-derive it from the
* running version.
*/
export function suggestedPackageSpec(_version: string): string {
return "akeru-bot";
}
/**
* Render an `akeru <subcommand>` suggestion that matches how this process was
* launched, so copy/pasting it works. An `npx akeru-bot connect` launch suggests
* `npx akeru-bot serve`, and a global install suggests `akeru serve`.
*/
export function formatCliCommand(input: {
readonly subcommand: string;
readonly entryPath: string;
readonly version: string;
}): string {
const runner = detectCliRunner(input.entryPath);
if (runner === null) {
return `akeru ${input.subcommand}`;
}
return `${runner} ${suggestedPackageSpec(input.version)} ${input.subcommand}`;
}
/** `formatCliCommand` against this process's real entry path and version. */
export const resolveCliCommand = (subcommand: string) =>
Effect.map(HostProcessArguments, (processArguments) =>
formatCliCommand({
subcommand,
entryPath: processArguments[1] ?? "",
version: packageJson.version,
}),
);