/**
 * CodexPetHub CLI — argv parser and entry point.
 */
import { type InstallOptions, type InstallResult } from "./install.js";
export declare const HELP_TEXT = "codexpethub \u2014 install custom OpenAI Codex pets\n\nUsage:\n  codexpethub install <slug> [--codex-home <path>] [--overwrite] [--registry-url <url>]\n  codexpethub --help\n\nCommands:\n  install <slug>          Download and verify the pet, install into ~/.codex/pets/<slug>/\n\nOptions:\n  --codex-home <path>     Override the install root (default: $CODEX_HOME or ~/.codex)\n  --overwrite             Replace an existing install for this slug\n  --registry-url <url>    Use a custom registry (default: https://codexpethub.com)\n  -h, --help              Show this help and exit\n\nExamples:\n  npx codexpethub install null-puff\n  npx codexpethub install boba --overwrite\n  npx codexpethub install boba --codex-home /tmp/test-codex\n\nEach install verifies the pet against the sha256 hashes in the public manifest.";
export declare class UsageError extends Error {
    constructor(message: string);
}
export interface ParsedArgs {
    command: "install" | "help";
    slug?: string;
    registryUrl?: string;
    codexHome?: string;
    overwrite?: boolean;
}
export declare function parseArgv(argv: readonly string[]): ParsedArgs;
export interface RunOptions {
    stdout?: (line: string) => void;
    stderr?: (line: string) => void;
    /** Test injection — replaces installPet so main() never touches the network. */
    installImpl?: (opts: InstallOptions) => Promise<InstallResult>;
}
export declare function main(argv: readonly string[], options?: RunOptions): Promise<number>;
//# sourceMappingURL=cli.d.ts.map