/**
 * Client configuration writer.
 *
 * The four target agents disagree on file format (JSON vs TOML), file location,
 * and key names — and getting any of them wrong produces a silent no-op rather
 * than an error. Encoding that here means a user types one command instead of
 * reading four sets of docs.
 */
export type ClientId = "claude" | "codex" | "gemini" | "cursor" | "vscode" | "windsurf" | "opencode";
export declare const CLIENTS: ClientId[];
export interface InstallOptions {
    scope: "user" | "project";
    projectDir: string;
    command: string;
    args: string[];
    env: Record<string, string>;
    dryRun: boolean;
}
export interface InstallResult {
    client: ClientId;
    file: string;
    written: boolean;
    note?: string;
}
export declare function configPath(client: ClientId, opts: InstallOptions): string;
export declare function install(client: ClientId, opts: InstallOptions): InstallResult;
/**
 * Write AGENTS.md guidance for clients with no plugin or skill system.
 * Returns the block so callers can show it rather than write it.
 */
export declare function agentsMarkdown(): string;
export declare function mergeAgentsFile(target: string, dryRun: boolean): {
    written: boolean;
    file: string;
};