@pentoshi/clai 0.2.0

package/dist/tools/fs.js

@@ -0,0 +1,82 @@
+import { readFile, readdir, writeFile } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { homedir } from "node:os";
+import { execa } from "execa";
+import { getConfig } from "../store/config.js";
+function expandHome(path) {
+    if (path === "~")
+        return homedir();
+    if (path.startsWith("~/") || path.startsWith("~\\")) {
+        return resolve(homedir(), path.slice(2));
+    }
+    return path;
+}
+/** Resolve path with tilde expansion — no sandbox check (read-only callers) */
+function resolvePath(path) {
+    return resolve(expandHome(path));
+}
+/** Resolve + sandbox check for write operations only */
+function ensureWriteAllowed(path) {
+    const resolved = resolvePath(path);
+    const roots = [
+        ...getConfig().sandboxRoots.map((root) => resolve(expandHome(root))),
+        resolve(homedir()),
+    ];
+    const allowed = roots.some((root) => {
+        const rel = relative(root, resolved);
+        return (rel === "" || (!rel.startsWith("..") && !resolve(rel).startsWith("..")));
+    });
+    if (!allowed) {
+        throw new Error(`Write blocked — path is outside approved roots: ${path}`);
+    }
+    return resolved;
+}
+export async function fsRead(path) {
+    const resolved = resolvePath(path);
+    const content = await readFile(resolved, "utf8");
+    return { ok: true, output: content };
+}
+export async function fsWrite(path, content) {
+    const resolved = ensureWriteAllowed(path);
+    await writeFile(resolved, content, "utf8");
+    return { ok: true, output: `Wrote ${resolved}` };
+}
+export async function fsList(path) {
+    const resolved = resolvePath(path);
+    const entries = await readdir(resolved, { withFileTypes: true });
+    return {
+        ok: true,
+        output: entries
+            .map((entry) => `${entry.isDirectory() ? "dir " : "file"} ${entry.name}`)
+            .join("\n"),
+    };
+}
+export async function fsSearch(pattern, path = process.cwd()) {
+    const resolved = resolvePath(path);
+    const maxLines = 50;
+    try {
+        const result = await execa("rg", ["--max-count", "5", "--max-filesize", "1M", "-l", pattern, resolved], {
+            reject: false,
+            all: true,
+            timeout: 15_000,
+        });
+        return {
+            ok: result.exitCode === 0,
+            output: result.all ?? "",
+            exitCode: result.exitCode,
+        };
+    }
+    catch {
+        const result = await execa("grep", ["-R", "-l", "-m", String(maxLines), pattern, resolved], {
+            reject: false,
+            all: true,
+            timeout: 15_000,
+        });
+        return {
+            ok: result.exitCode === 0,
+            output: result.all ?? "",
+            exitCode: result.exitCode,
+        };
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/tools/fs.js.map

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

package/dist/tools/http.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult } from "../types.js";
+export declare function httpFetch(url: string, options?: {
+    method?: string | undefined;
+    body?: string | undefined;
+    maxBytes?: number | undefined;
+}): Promise<ToolResult>;

package/dist/tools/http.js

@@ -0,0 +1,14 @@
+export async function httpFetch(url, options = {}) {
+    const response = await fetch(url, {
+        method: options.method ?? "GET",
+        body: options.body ?? null,
+    });
+    const limit = options.maxBytes ?? 1_000_000;
+    const text = await response.text();
+    return {
+        ok: response.ok,
+        output: text.slice(0, limit),
+        exitCode: response.status,
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/tools/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/tools/http.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,UAII,EAAE;IAEN,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;KAC3B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC5B,QAAQ,EAAE,QAAQ,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,5 @@
+import type { ToolCall, ToolResult } from '../types.js';
+export type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
+export declare const toolRegistry: Record<string, ToolHandler>;
+export declare function availableToolNames(): string[];
+export declare function runToolCall(call: ToolCall): Promise<ToolResult>;

package/dist/tools/registry.js

@@ -0,0 +1,79 @@
+import { detectSystem } from '../os/detect.js';
+import { detectPackageManager } from '../os/pkgmgr.js';
+import { fsList, fsRead, fsSearch, fsWrite } from './fs.js';
+import { httpFetch } from './http.js';
+import { shellExec } from './shell.js';
+function requireString(args, key) {
+    const value = args[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`Tool argument "${key}" must be a non-empty string`);
+    }
+    return value;
+}
+function optionalString(args, key) {
+    const value = args[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function optionalNumber(args, key) {
+    const value = args[key];
+    return typeof value === 'number' ? value : undefined;
+}
+export const toolRegistry = {
+    async 'shell.exec'(args) {
+        return shellExec({ command: requireString(args, 'command'), cwd: optionalString(args, 'cwd'), timeoutMs: optionalNumber(args, 'timeoutMs') });
+    },
+    async 'fs.read'(args) {
+        return fsRead(requireString(args, 'path'));
+    },
+    async 'fs.write'(args) {
+        return fsWrite(requireString(args, 'path'), requireString(args, 'content'));
+    },
+    async 'fs.list'(args) {
+        return fsList(optionalString(args, 'path') ?? process.cwd());
+    },
+    async 'fs.search'(args) {
+        return fsSearch(requireString(args, 'pattern'), optionalString(args, 'path'));
+    },
+    async 'pkg.install'(args) {
+        const tool = requireString(args, 'tool');
+        const pkgmgr = await detectPackageManager();
+        return shellExec({ command: pkgmgr.installCommand(tool) });
+    },
+    async 'net.scan'(args) {
+        const target = requireString(args, 'target');
+        const ports = optionalString(args, 'ports');
+        const command = ports ? `nmap -p ${ports} ${target}` : `nmap ${target}`;
+        return shellExec({ command, timeoutMs: 120_000 });
+    },
+    async 'http.fetch'(args) {
+        return httpFetch(requireString(args, 'url'), {
+            method: optionalString(args, 'method'),
+            body: optionalString(args, 'body'),
+            maxBytes: optionalNumber(args, 'maxBytes'),
+        });
+    },
+    async sysinfo() {
+        return { ok: true, output: JSON.stringify(detectSystem(), null, 2) };
+    },
+    async 'pentest.recon'(args) {
+        const target = requireString(args, 'target');
+        const commands = [`whois ${target}`, `dig ${target}`, `nmap --top-ports 100 ${target}`];
+        const outputs = [];
+        for (const command of commands) {
+            const result = await shellExec({ command, timeoutMs: 120_000 });
+            outputs.push(`$ ${command}\n${result.output}`);
+        }
+        return { ok: true, output: outputs.join('\n\n') };
+    },
+};
+export function availableToolNames() {
+    return Object.keys(toolRegistry);
+}
+export async function runToolCall(call) {
+    const handler = toolRegistry[call.name];
+    if (!handler) {
+        throw new Error(`Unknown tool: ${call.name}`);
+    }
+    return handler(call.args);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/shell.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult } from "../types.js";
+export interface ShellExecArgs {
+    command: string;
+    cwd?: string | undefined;
+    timeoutMs?: number | undefined;
+}
+export declare function shellExec(args: ShellExecArgs): Promise<ToolResult>;

package/dist/tools/shell.js

@@ -0,0 +1,16 @@
+import { execaCommand } from "execa";
+export async function shellExec(args) {
+    const subprocess = await execaCommand(args.command, {
+        cwd: args.cwd ?? process.cwd(),
+        timeout: args.timeoutMs ?? 120_000,
+        reject: false,
+        all: true,
+        shell: true,
+    });
+    return {
+        ok: subprocess.exitCode === 0,
+        output: subprocess.all ?? `${subprocess.stdout}\n${subprocess.stderr}`.trim(),
+        exitCode: subprocess.exitCode,
+    };
+}
+//# sourceMappingURL=shell.js.map

package/dist/tools/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/tools/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AASrC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE;QAClD,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAC9B,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,OAAO;QAClC,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,QAAQ,KAAK,CAAC;QAC7B,MAAM,EACJ,UAAU,CAAC,GAAG,IAAI,GAAG,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;QACvE,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+export declare const providerIds: readonly ["groq", "gemini", "openrouter", "openai", "anthropic", "ollama"];
+export type ProviderId = (typeof providerIds)[number];
+export type Mode = "ask" | "agent";
+export type RiskLevel = "safe" | "confirm" | "block";
+export interface ChatMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+}
+export interface CompletionRequest {
+    provider?: ProviderId | undefined;
+    model?: string | undefined;
+    messages: ChatMessage[];
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    signal?: AbortSignal | undefined;
+}
+export interface CompletionResult {
+    text: string;
+    provider: ProviderId;
+    model: string;
+}
+export interface ProviderStatus {
+    provider: ProviderId;
+    label: string;
+    active: boolean;
+    configured: boolean;
+    source: "env" | "keychain" | "fallback" | "local" | "missing";
+    maskedKey?: string | undefined;
+    model: string;
+    note?: string | undefined;
+}
+export interface ToolCall {
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface ToolResult {
+    ok: boolean;
+    output: string;
+    exitCode?: number | undefined;
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+export const providerIds = [
+    "groq",
+    "gemini",
+    "openrouter",
+    "openai",
+    "anthropic",
+    "ollama",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,QAAQ;CACA,CAAC"}

package/dist/ui/banner.d.ts

@@ -0,0 +1,12 @@
+export declare function renderBanner(version: string): string;
+export declare function renderSessionInfo(opts: {
+    workdir: string;
+    model: string;
+    provider: string;
+    mode: string;
+}): string;
+export declare function renderSuggestions(): string;
+export declare function renderModeSwitch(mode: string): string;
+export declare function renderProviderSwitch(provider: string, model: string): string;
+export declare const PROMPT: string;
+export declare const PROMPT_SECONDARY: string;

package/dist/ui/banner.js

@@ -0,0 +1,55 @@
+import chalk from "chalk";
+import { homedir } from "node:os";
+// ── Box drawing helpers ─────────────────────────────────────────────────────
+function stripAnsi(str) {
+    // biome-ignore lint: escape sequences are intentional
+    return str.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function box(lines, opts = {}) {
+    const color = opts.color ?? chalk.gray;
+    const contentWidth = Math.max(opts.minWidth ?? 60, ...lines.map((l) => stripAnsi(l).length));
+    const top = color(`╭${"─".repeat(contentWidth + 2)}╮`);
+    const bottom = color(`╰${"─".repeat(contentWidth + 2)}╯`);
+    const padded = lines.map((l) => {
+        const pad = contentWidth - stripAnsi(l).length;
+        return `${color("│")} ${l}${" ".repeat(Math.max(0, pad))} ${color("│")}`;
+    });
+    return [top, ...padded, bottom].join("\n");
+}
+// ── Public rendering functions ──────────────────────────────────────────────
+export function renderBanner(version) {
+    return box([`${chalk.magenta("●")} ${chalk.bold.white("clai")} ${chalk.dim(`v${version}`)}`], { minWidth: 58 });
+}
+export function renderSessionInfo(opts) {
+    const home = homedir();
+    const workdir = opts.workdir.startsWith(home)
+        ? `~${opts.workdir.slice(home.length)}`
+        : opts.workdir;
+    return box([
+        `${chalk.dim("↳ workdir:")}  ${workdir}`,
+        `${chalk.dim("↳ model:")}    ${chalk.cyan(opts.model)}`,
+        `${chalk.dim("↳ provider:")} ${chalk.green(opts.provider)}`,
+        `${chalk.dim("↳ mode:")}     ${chalk.yellow(opts.mode)}`,
+    ], { minWidth: 58 });
+}
+export function renderSuggestions() {
+    const suggestions = [
+        "scan my network",
+        "find open ports on 192.168.1.1",
+        "what is my IP?",
+        "read my .zshrc",
+    ];
+    return chalk.dim("  try: ") + chalk.dim.italic(suggestions.join(" │ "));
+}
+export function renderModeSwitch(mode) {
+    return box([`${chalk.dim("mode →")} ${chalk.yellow(mode)}`], { minWidth: 30 });
+}
+export function renderProviderSwitch(provider, model) {
+    return box([
+        `${chalk.dim("provider →")} ${chalk.green(provider)}`,
+        `${chalk.dim("model →")}    ${chalk.cyan(model)}`,
+    ], { minWidth: 30 });
+}
+export const PROMPT = `${chalk.magenta("❯")} `;
+export const PROMPT_SECONDARY = `${chalk.gray("…")} `;
+//# sourceMappingURL=banner.js.map

package/dist/ui/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,+EAA+E;AAE/E,SAAS,SAAS,CAAC,GAAW;IAC5B,sDAAsD;IACtD,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,GAAG,CACV,KAAe,EACf,OAA6D,EAAE;IAE/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,IAAI,CAAC,QAAQ,IAAI,EAAE,EACnB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CACzC,CAAC;IACF,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/C,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,GAAG,CACR,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,CAAC,EACjF,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAKjC;IACC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3C,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QACvC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IAEjB,OAAO,GAAG,CACR;QACE,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,OAAO,EAAE;QACxC,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACvD,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAC3D,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACzD,EACD,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,WAAW,GAAG;QAClB,iBAAiB;QACjB,gCAAgC;QAChC,gBAAgB;QAChB,gBAAgB;KACjB,CAAC;IACF,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,GAAG,CACR,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAChD,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,KAAa;IAClE,OAAO,GAAG,CACR;QACE,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;QACrD,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;KAClD,EACD,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@pentoshi/clai",
+  "version": "0.2.0",
+  "description": "A fast, cross-platform AI CLI assistant with ask and agent modes for shell tasks, file operations, and cybersecurity workflows.",
+  "type": "module",
+  "license": "MIT",
+  "author": "pentoshi007",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pentoshi007/clai.git"
+  },
+  "homepage": "https://github.com/pentoshi007/clai",
+  "keywords": [
+    "cli",
+    "ai",
+    "agent",
+    "terminal",
+    "cybersecurity",
+    "pentesting",
+    "nmap",
+    "llm",
+    "groq",
+    "gemini",
+    "ollama"
+  ],
+  "bin": {
+    "clai": "bin/clai.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "compile": "bun run scripts/build.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "doctor": "tsx src/index.ts doctor"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.2.3",
+    "chalk": "^5.4.1",
+    "commander": "^12.1.0",
+    "conf": "^13.1.0",
+    "execa": "^9.5.2",
+    "ora": "^8.1.1",
+    "zod": "^3.24.1"
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^11.7.0",
+    "keytar": "^7.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}