llm-config-cli 0.1.0

package/dist/shells/cleanup.d.ts

@@ -0,0 +1,6 @@
+import type { ChangePlan, ProviderId } from '../core/types.js';
+export declare function planShellCleanup(args: {
+    shellFile?: string;
+    provider?: ProviderId;
+    backup?: boolean;
+}): Promise<ChangePlan>;

package/dist/shells/cleanup.js

@@ -0,0 +1,42 @@
+import fs from 'node:fs/promises';
+import { planFileWrite } from '../core/change-plan.js';
+import { removeManagedEntries } from './managed-blocks.js';
+async function readIfExists(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return '';
+        }
+        throw error;
+    }
+}
+export async function planShellCleanup(args) {
+    if (!args.shellFile) {
+        return {
+            provider: args.provider ?? 'claude-code',
+            summary: args.provider
+                ? `Remove managed ${args.provider} environment variables`
+                : 'Remove all managed environment variables',
+            changes: [
+                {
+                    type: 'notice',
+                    message: 'No shell file resolved for managed environment cleanup.',
+                },
+            ],
+        };
+    }
+    const before = await readIfExists(args.shellFile);
+    const after = removeManagedEntries(before, args.provider);
+    return planFileWrite({
+        path: args.shellFile,
+        nextContent: after,
+        provider: args.provider ?? 'claude-code',
+        summary: args.provider
+            ? `Remove managed ${args.provider} environment variables`
+            : 'Remove all managed environment variables',
+        backup: args.backup,
+    });
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/shells/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/shells/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAItC;IACC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,aAAa;YACxC,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACpB,CAAC,CAAC,kBAAkB,IAAI,CAAC,QAAQ,wBAAwB;gBACzD,CAAC,CAAC,0CAA0C;YAC9C,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,yDAAyD;iBACnE;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1D,OAAO,aAAa,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC,SAAS;QACpB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,aAAa;QACxC,OAAO,EAAE,IAAI,CAAC,QAAQ;YACpB,CAAC,CAAC,kBAAkB,IAAI,CAAC,QAAQ,wBAAwB;YACzD,CAAC,CAAC,0CAA0C;QAC9C,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/shells/discovery.d.ts

@@ -0,0 +1,4 @@
+export declare function discoverShellFiles(options?: {
+    homeDir?: string;
+    preferred?: string;
+}): Promise<string[]>;

package/dist/shells/discovery.js

@@ -0,0 +1,19 @@
+import fs from 'node:fs/promises';
+import { getCandidateShellFiles } from '../core/paths.js';
+export async function discoverShellFiles(options = {}) {
+    const candidates = options.preferred ? [options.preferred] : getCandidateShellFiles({ homeDir: options.homeDir });
+    const existing = [];
+    for (const file of candidates) {
+        try {
+            await fs.access(file);
+            existing.push(file);
+        }
+        catch {
+            if (options.preferred) {
+                existing.push(file);
+            }
+        }
+    }
+    return existing.length > 0 ? existing : [candidates[0]];
+}
+//# sourceMappingURL=discovery.js.map

package/dist/shells/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/shells/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAoD,EAAE;IAC7F,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAClH,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/shells/managed-blocks.d.ts

@@ -0,0 +1,10 @@
+import type { ManagedEnvEntry, ProviderId } from '../core/types.js';
+export declare const BLOCK_START = "# BEGIN llm-config managed block";
+export declare const BLOCK_END = "# END llm-config managed block";
+export declare function parseManagedBlock(content: string): {
+    start: number;
+    end: number;
+} | undefined;
+export declare function upsertManagedBlock(content: string, entries: ManagedEnvEntry[]): string;
+export declare function getManagedEntries(content: string): ManagedEnvEntry[];
+export declare function removeManagedEntries(content: string, provider?: ProviderId): string;

package/dist/shells/managed-blocks.js

@@ -0,0 +1,80 @@
+export const BLOCK_START = '# BEGIN llm-config managed block';
+export const BLOCK_END = '# END llm-config managed block';
+function formatEntry(entry) {
+    return `export ${entry.key}=${JSON.stringify(entry.value)} # llm-config:${entry.provider}`;
+}
+function splitLines(content) {
+    return content === '' ? [] : content.replace(/\n$/, '').split('\n');
+}
+export function parseManagedBlock(content) {
+    const lines = splitLines(content);
+    const start = lines.findIndex((line) => line.trim() === BLOCK_START);
+    if (start === -1) {
+        return undefined;
+    }
+    const end = lines.findIndex((line, index) => index > start && line.trim() === BLOCK_END);
+    if (end === -1) {
+        return undefined;
+    }
+    return { start, end };
+}
+export function upsertManagedBlock(content, entries) {
+    const lines = splitLines(content);
+    const blockLines = [BLOCK_START, ...entries.map(formatEntry), BLOCK_END];
+    const range = parseManagedBlock(content);
+    if (!range) {
+        const next = lines.length === 0 ? blockLines : [...lines, '', ...blockLines];
+        return `${next.join('\n')}\n`;
+    }
+    const next = [...lines.slice(0, range.start), ...blockLines, ...lines.slice(range.end + 1)];
+    return `${next.join('\n')}\n`;
+}
+export function getManagedEntries(content) {
+    const lines = splitLines(content);
+    const range = parseManagedBlock(content);
+    if (!range) {
+        return [];
+    }
+    return lines
+        .slice(range.start + 1, range.end)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .flatMap((line) => {
+        const match = line.match(/^export\s+([^=]+)=(.+?)\s+#\s+llm-config:([a-z-]+)$/);
+        if (!match) {
+            return [];
+        }
+        const [, key, rawValue, provider] = match;
+        try {
+            return [
+                {
+                    key,
+                    value: JSON.parse(rawValue),
+                    provider: provider,
+                },
+            ];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+export function removeManagedEntries(content, provider) {
+    const range = parseManagedBlock(content);
+    if (!range) {
+        return content;
+    }
+    const lines = splitLines(content);
+    const entries = getManagedEntries(content).filter((entry) => !provider || entry.provider !== provider);
+    if (entries.length === 0) {
+        const before = lines.slice(0, range.start);
+        const after = lines.slice(range.end + 1);
+        const next = [...before];
+        if (next[next.length - 1] === '' && after[0] === '') {
+            next.pop();
+        }
+        return [...next, ...after].join('\n').replace(/^\n+/, '').replace(/\n*$/, '\n');
+    }
+    return upsertManagedBlock(content, entries);
+}
+//# sourceMappingURL=managed-blocks.js.map

package/dist/shells/managed-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-blocks.js","sourceRoot":"","sources":["../../src/shells/managed-blocks.ts"],"names":[],"mappings":"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"}

package/dist/tests/provider-registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider-registry.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { getProvider, listProviders } from '../providers/registry.js';
+describe('provider registry', () => {
+    it('lists all providers', () => {
+        expect(listProviders().map((provider) => provider.id)).toEqual([
+            'claude-code',
+            'codex',
+            'openclaw',
+        ]);
+    });
+    it('resolves aliases', () => {
+        expect(getProvider('claude').id).toBe('claude-code');
+        expect(getProvider('codex').id).toBe('codex');
+    });
+    it('requires restore support on all providers', () => {
+        for (const provider of listProviders()) {
+            expect(typeof provider.planRestoreOfficial).toBe('function');
+        }
+    });
+    it('throws on unknown provider', () => {
+        expect(() => getProvider('unknown')).toThrow('Unknown provider: unknown');
+    });
+});
+//# sourceMappingURL=provider-registry.test.js.map

package/dist/tests/provider-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.test.js","sourceRoot":"","sources":["../../src/tests/provider-registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEtE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7D,aAAa;YACb,OAAO;YACP,UAAU;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,OAAO,QAAQ,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/restore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/restore.test.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { planShellCleanup } from '../shells/cleanup.js';
+import { codexProvider } from '../providers/codex.js';
+const tempDirs = [];
+async function makeTempHome() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'llm-config-test-'));
+    tempDirs.push(dir);
+    return dir;
+}
+afterEach(async () => {
+    await Promise.all(tempDirs.splice(0).map((dir) => fs.rm(dir, { recursive: true, force: true })));
+});
+describe('restore semantics', () => {
+    it('removes only managed codex fallback when official target exists', async () => {
+        const homeDir = await makeTempHome();
+        const shellFile = path.join(homeDir, '.zshrc');
+        const officialDir = path.join(homeDir, '.codex');
+        await fs.mkdir(officialDir, { recursive: true });
+        await fs.writeFile(path.join(officialDir, 'config.json'), '{"profile":"official"}\n');
+        await fs.writeFile(shellFile, [
+            'export USER_KEEP="1"',
+            '# BEGIN llm-config managed block',
+            'export CODEX_API_KEY="secret" # llm-config:codex',
+            'export CODEX_BASE_URL="https://fallback.example.com" # llm-config:codex',
+            'export OPENCLAW_API_KEY="other" # llm-config:openclaw',
+            '# END llm-config managed block',
+            '',
+        ].join('\n'));
+        const plan = await codexProvider.planRestoreOfficial({ homeDir, shellFile });
+        const writeChange = plan.changes.find((change) => change.type === 'write-file');
+        if (!writeChange || writeChange.type !== 'write-file') {
+            throw new Error('expected write-file change');
+        }
+        expect(plan.changes[0]).toEqual({
+            type: 'notice',
+            message: `Removing managed Codex fallback override from ${shellFile} so ${path.join(officialDir, 'config.json')} can become effective again.`,
+        });
+        expect(writeChange.after).toContain('export USER_KEEP="1"');
+        expect(writeChange.after).toContain('OPENCLAW_API_KEY');
+        expect(writeChange.after).not.toContain('CODEX_API_KEY');
+        expect(writeChange.after).not.toContain('CODEX_BASE_URL');
+        expect(await fs.readFile(path.join(officialDir, 'config.json'), 'utf8')).toBe('{"profile":"official"}\n');
+    });
+    it('fails restore when no official target exists', async () => {
+        const homeDir = await makeTempHome();
+        const shellFile = path.join(homeDir, '.zshrc');
+        await fs.writeFile(shellFile, [
+            '# BEGIN llm-config managed block',
+            'export CODEX_API_KEY="secret" # llm-config:codex',
+            '# END llm-config managed block',
+            '',
+        ].join('\n'));
+        const plan = await codexProvider.planRestoreOfficial({ homeDir, shellFile });
+        expect(plan.changes).toEqual([
+            {
+                type: 'notice',
+                message: 'Cannot restore Codex to official configuration because no confirmed official target was detected.',
+            },
+        ]);
+    });
+    it('does not delete handwritten env entries during restore', async () => {
+        const homeDir = await makeTempHome();
+        const shellFile = path.join(homeDir, '.zshrc');
+        const officialDir = path.join(homeDir, '.codex');
+        await fs.mkdir(officialDir, { recursive: true });
+        await fs.writeFile(path.join(officialDir, 'config.json'), '{}\n');
+        await fs.writeFile(shellFile, [
+            'export CODEX_API_KEY="handwritten"',
+            '# BEGIN llm-config managed block',
+            'export CODEX_API_KEY="managed" # llm-config:codex',
+            '# END llm-config managed block',
+            '',
+        ].join('\n'));
+        const plan = await codexProvider.planRestoreOfficial({ homeDir, shellFile });
+        const writeChange = plan.changes.find((change) => change.type === 'write-file');
+        if (!writeChange || writeChange.type !== 'write-file') {
+            throw new Error('expected write-file change');
+        }
+        expect(writeChange.after).toContain('export CODEX_API_KEY="handwritten"');
+        expect(writeChange.after).not.toContain('# llm-config:codex');
+    });
+    it('returns a notice instead of using an empty shell path during env cleanup', async () => {
+        const plan = await planShellCleanup({ provider: 'codex' });
+        expect(plan.changes).toEqual([
+            {
+                type: 'notice',
+                message: 'No shell file resolved for managed environment cleanup.',
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=restore.test.js.map

package/dist/tests/restore.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.test.js","sourceRoot":"","sources":["../../src/tests/restore.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/shell-cleanup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/shell-cleanup.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { getManagedEntries, removeManagedEntries, upsertManagedBlock } from '../shells/managed-blocks.js';
+describe('managed shell cleanup', () => {
+    it('adds a managed block without touching user exports', () => {
+        const before = 'export USER_VALUE="keep"\n';
+        const after = upsertManagedBlock(before, [
+            { key: 'CODEX_API_KEY', value: 'secret', provider: 'codex' },
+        ]);
+        expect(after).toContain('export USER_VALUE="keep"');
+        expect(after).toContain('# BEGIN llm-config managed block');
+        expect(after).toContain('export CODEX_API_KEY="secret" # llm-config:codex');
+    });
+    it('removes only one provider from the managed block', () => {
+        const before = [
+            'export USER_VALUE="keep"',
+            '# BEGIN llm-config managed block',
+            'export CODEX_API_KEY="secret" # llm-config:codex',
+            'export OPENCLAW_API_KEY="other" # llm-config:openclaw',
+            '# END llm-config managed block',
+            '',
+        ].join('\n');
+        const after = removeManagedEntries(before, 'codex');
+        expect(after).toContain('export USER_VALUE="keep"');
+        expect(after).not.toContain('CODEX_API_KEY');
+        expect(after).toContain('OPENCLAW_API_KEY');
+    });
+    it('removes the whole block when last managed entry is deleted', () => {
+        const before = [
+            'export USER_VALUE="keep"',
+            '# BEGIN llm-config managed block',
+            'export CODEX_API_KEY="secret" # llm-config:codex',
+            '# END llm-config managed block',
+            '',
+        ].join('\n');
+        const after = removeManagedEntries(before, 'codex');
+        expect(after).toBe('export USER_VALUE="keep"\n');
+    });
+    it('preserves other providers and user exports during restore-style cleanup', () => {
+        const before = [
+            'export USER_VALUE="keep"',
+            '# BEGIN llm-config managed block',
+            'export CODEX_API_KEY="secret" # llm-config:codex',
+            'export OPENCLAW_API_KEY="other" # llm-config:openclaw',
+            '# END llm-config managed block',
+            'export USER_AFTER="keep-too"',
+            '',
+        ].join('\n');
+        const after = removeManagedEntries(before, 'codex');
+        expect(after).toContain('export USER_VALUE="keep"');
+        expect(after).toContain('export USER_AFTER="keep-too"');
+        expect(after).not.toContain('CODEX_API_KEY');
+        expect(after).toContain('OPENCLAW_API_KEY');
+    });
+    it('parses managed entries with provider markers', () => {
+        const content = [
+            '# BEGIN llm-config managed block',
+            'export OPENCLAW_BASE_URL="https://example.com" # llm-config:openclaw',
+            '# END llm-config managed block',
+            '',
+        ].join('\n');
+        expect(getManagedEntries(content)).toEqual([
+            {
+                key: 'OPENCLAW_BASE_URL',
+                value: 'https://example.com',
+                provider: 'openclaw',
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=shell-cleanup.test.js.map

package/dist/tests/shell-cleanup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-cleanup.test.js","sourceRoot":"","sources":["../../src/tests/shell-cleanup.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "llm-config-cli",
+  "version": "0.1.0",
+  "description": "CLI for configuring Claude Code, Codex, and OpenClaw API settings",
+  "type": "module",
+  "bin": {
+    "llm-config": "dist/bin/llm-config.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/bin/llm-config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "pack:check": "npm pack --dry-run"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.3.2",
+    "commander": "^14.0.0",
+    "picocolors": "^1.1.1",
+    "zod": "^4.1.5"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}