@xwss/agentbell 0.1.0

package/RELEASE.md

@@ -0,0 +1,31 @@
+# Release Checklist
+
+Run these checks before publishing AgentBell to npm.
+
+The npm package is scoped as `@xwss/agentbell`, while the installed CLI command remains `agentbell`.
+
+1. `npm run build`
+2. `npm test`
+3. `npm run lint`
+4. `npm run check:package`
+5. `npm pack --dry-run`
+6. Inspect package contents and confirm no token, topic, log, backup, hook wrapper, `.env`, or local test file is included.
+7. `npm pack`
+8. Install the tarball locally:
+   ```bash
+   npm install -g ./xwss-agentbell-0.1.0.tgz
+   ```
+9. Smoke test:
+   ```bash
+   agentbell --help
+   agentbell setup --dry-run --yes --targets none --no-test
+   agentbell verify --dry-run --json
+   ```
+10. Publish only after the checks above pass:
+    ```bash
+    npm publish --access public --tag beta
+    ```
+
+Do not publish real ntfy topics, auth tokens, `.env` files, logs, backups, or generated local hook wrappers.
+
+

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { runDoctor } from './commands/doctor.js';
+import { runInit } from './commands/init.js';
+import { runInitHooks } from './commands/initHooks.js';
+import { runProjectInit } from './commands/project.js';
+import { runSend } from './commands/send.js';
+import { runSetup } from './commands/setup.js';
+import { runTest } from './commands/test.js';
+import { runVerify } from './commands/verify.js';
+import { logger } from './utils/logger.js';
+const program = new Command();
+program
+    .name('agentbell')
+    .description('AgentBell: get notified when your AI coding agent finishes.')
+    .version('0.1.0');
+program
+    .command('send')
+    .description('Send one notification. Intended for AI coding agent hooks.')
+    .option('--tool <tool>', 'AI coding tool name, e.g. claude-code/codex/vscode-agent/custom')
+    .option('--event <event>', 'Lifecycle event, e.g. stop/notification/error/permission/custom')
+    .option('--title <title>', 'Notification title')
+    .option('--message <message>', 'Notification message')
+    .option('--priority <priority>', 'ntfy priority, default comes from config')
+    .option('--tags <tags>', 'Comma-separated ntfy tags')
+    .option('--config <path>', 'Config file path')
+    .option('--project <name>', 'Project display name')
+    .option('--task <name>', 'Task name for notification context')
+    .option('--cwd <path>', 'Context working directory')
+    .option('--branch <branch>', 'Git branch for notification context')
+    .option('--template-title <template>', 'Temporary title template override')
+    .option('--template-message <template>', 'Temporary message template override')
+    .action((options) => runSend(options).catch(handleError));
+program
+    .command('test')
+    .description('Send a test notification to your phone.')
+    .option('--config <path>', 'Config file path')
+    .option('--project <name>', 'Project display name')
+    .option('--task <name>', 'Task name for notification context')
+    .option('--cwd <path>', 'Context working directory')
+    .option('--branch <branch>', 'Git branch for notification context')
+    .action((options) => runTest(options).catch(handleError));
+program
+    .command('doctor')
+    .description('Print diagnostics for AgentBell setup and hooks.')
+    .option('--config <path>', 'Config file path')
+    .option('--json', 'Output diagnostics as JSON')
+    .action((options) => runDoctor(options).catch(handleError));
+program
+    .command('verify')
+    .description('Verify AgentBell config, hook files, wrappers, and notification chain.')
+    .option('--target <target>', 'codex, claude-code, vscode-agent, or all', 'all')
+    .option('--config <path>', 'Config file path')
+    .option('--send-test', 'Send a verify test notification')
+    .option('--run-wrapper', 'Run target wrapper commands')
+    .option('--dry-run', 'Only inspect files and config; do not send notifications or run wrappers')
+    .option('--json', 'Output verify report as JSON')
+    .action((options) => runVerify(options).catch(handleError));
+program
+    .command('setup')
+    .description('Run the first-use setup wizard.')
+    .option('--config <path>', 'Config file path')
+    .option('--topic <topic>', 'Use a specific ntfy topic')
+    .option('--machine-name <name>', 'Machine display name for notifications')
+    .option('--server <url>', 'ntfy server URL')
+    .option('--targets <targets>', 'all, none, or comma-separated codex,claude-code,vscode-agent')
+    .option('--yes', 'Use defaults for prompts')
+    .option('--no-test', 'Skip setup test notification')
+    .option('--dry-run', 'Preview setup without writing files, sending notifications, or installing hooks')
+    .option('--init-project', 'Create .agentbell.json in the current project')
+    .option('--project-name <name>', 'Project name for .agentbell.json when --init-project is used')
+    .action((options) => runSetup({ ...options, noTest: options.test === false }).catch(handleError));
+const project = program
+    .command('project')
+    .description('Manage project-level AgentBell config.');
+project
+    .command('init')
+    .description('Create .agentbell.json in the current project.')
+    .option('--name <name>', 'Project display name')
+    .option('--task <task>', 'Default task name')
+    .option('--force', 'Overwrite an existing .agentbell.json after creating a backup')
+    .action((options) => runProjectInit(options).catch(handleError));
+program
+    .command('init')
+    .description('Interactively create ~/.agentbell/config.json.')
+    .option('--config <path>', 'Config file path')
+    .action((options) => runInit(options).catch(handleError));
+program
+    .command('init-hooks')
+    .description('Generate hook configuration templates.')
+    .requiredOption('--target <target>', 'claude-code, codex, vscode-agent, or all')
+    .option('--dry-run', 'Preview hook changes without writing files')
+    .action((options) => {
+    const allowed = ['claude-code', 'codex', 'vscode-agent', 'all'];
+    if (!allowed.includes(options.target)) {
+        handleError(new Error(`Invalid target: ${options.target}. Expected one of ${allowed.join(', ')}`));
+        return;
+    }
+    runInitHooks(options).catch(handleError);
+});
+function handleError(error) {
+    logger.error(error.message);
+    process.exitCode = 1;
+}
+await program.parseAsync(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAmB,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,4DAA4D,CAAC;KACzE,MAAM,CAAC,eAAe,EAAE,iEAAiE,CAAC;KAC1F,MAAM,CAAC,iBAAiB,EAAE,iEAAiE,CAAC;KAC5F,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;KACrD,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,CAAC;KAC3E,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAAC;KACpD,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;KAClD,MAAM,CAAC,eAAe,EAAE,oCAAoC,CAAC;KAC7D,MAAM,CAAC,cAAc,EAAE,2BAA2B,CAAC;KACnD,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;KAClE,MAAM,CAAC,6BAA6B,EAAE,mCAAmC,CAAC;KAC1E,MAAM,CAAC,+BAA+B,EAAE,qCAAqC,CAAC;KAC9E,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AAE5D,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;KAClD,MAAM,CAAC,eAAe,EAAE,oCAAoC,CAAC;KAC7D,MAAM,CAAC,cAAc,EAAE,2BAA2B,CAAC;KACnD,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;KAClE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AAE5D,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,QAAQ,EAAE,4BAA4B,CAAC;KAC9C,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9D,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,wEAAwE,CAAC;KACrF,MAAM,CAAC,mBAAmB,EAAE,0CAA0C,EAAE,KAAK,CAAC;KAC9E,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,aAAa,EAAE,iCAAiC,CAAC;KACxD,MAAM,CAAC,eAAe,EAAE,6BAA6B,CAAC;KACtD,MAAM,CAAC,WAAW,EAAE,0EAA0E,CAAC;KAC/F,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;KAChD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AAC9D,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;KACtD,MAAM,CAAC,uBAAuB,EAAE,wCAAwC,CAAC;KACzE,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;KAC3C,MAAM,CAAC,qBAAqB,EAAE,8DAA8D,CAAC;KAC7F,MAAM,CAAC,OAAO,EAAE,0BAA0B,CAAC;KAC3C,MAAM,CAAC,WAAW,EAAE,8BAA8B,CAAC;KACnD,MAAM,CAAC,WAAW,EAAE,iFAAiF,CAAC;KACtG,MAAM,CAAC,gBAAgB,EAAE,+CAA+C,CAAC;KACzE,MAAM,CAAC,uBAAuB,EAAE,8DAA8D,CAAC;KAC/F,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AAEpG,MAAM,OAAO,GAAG,OAAO;KACpB,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,wCAAwC,CAAC,CAAC;AAEzD,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;KAC5C,MAAM,CAAC,SAAS,EAAE,+DAA+D,CAAC;KAClF,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACnE,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;KAC7C,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AAE5D,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,wCAAwC,CAAC;KACrD,cAAc,CAAC,mBAAmB,EAAE,0CAA0C,CAAC;KAC/E,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC;KACjE,MAAM,CAAC,CAAC,OAAiD,EAAE,EAAE;IAC5D,MAAM,OAAO,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,WAAW,CAAC,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,MAAM,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACnG,OAAO;IACT,CAAC;IAED,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,CAAC,KAAK,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,4 @@
+export declare function runDoctor(options: {
+    config?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/doctor.js

@@ -0,0 +1,159 @@
+import os from 'node:os';
+import { access } from 'node:fs/promises';
+import { loadConfig, resolveConfigPath } from '../config.js';
+import { currentCliInvocation } from '../utils/paths.js';
+import { maskSecret } from '../utils/mask.js';
+import { logger } from '../utils/logger.js';
+import { commandExists } from '../utils/shell.js';
+async function canAccess(url) {
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            signal: AbortSignal.timeout(5000)
+        });
+        return {
+            reachable: true,
+            detail: `${response.ok ? 'ok' : 'reachable'} (HTTP ${response.status})`
+        };
+    }
+    catch (error) {
+        return {
+            reachable: false,
+            detail: `failed (${error.message})`
+        };
+    }
+}
+async function localNotificationSupport() {
+    if (process.platform === 'darwin') {
+        return { supported: true, method: 'osascript display notification' };
+    }
+    if (process.platform === 'linux') {
+        if (await commandExists('notify-send')) {
+            return { supported: true, method: 'notify-send' };
+        }
+        return { supported: false, reason: 'notify-send was not found in PATH' };
+    }
+    if (process.platform === 'win32') {
+        return {
+            supported: false,
+            reason: 'Windows local toast is skipped in this MVP; ntfy phone push still works'
+        };
+    }
+    return { supported: false, reason: `unsupported platform: ${process.platform}` };
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function buildDoctorReport(configPathOption) {
+    const configPath = resolveConfigPath(configPathOption);
+    const warnings = [];
+    const errors = [];
+    const textDetails = [];
+    const cli = currentCliInvocation();
+    const report = {
+        platform: process.platform,
+        arch: process.arch,
+        nodeVersion: process.version,
+        hostname: os.hostname(),
+        username: os.userInfo().username,
+        cwd: process.cwd(),
+        executablePath: process.execPath,
+        configPath,
+        configExists: await fileExists(configPath),
+        localNotificationSupport: await localNotificationSupport(),
+        hookTargets: [
+            { target: 'codex', command: `${cli} send --tool codex --event stop` },
+            { target: 'claude-code', command: `${cli} send --tool claude-code --event stop` },
+            { target: 'vscode-agent', command: `${cli} send --tool vscode-agent --event stop` }
+        ],
+        warnings,
+        errors
+    };
+    if (!report.configExists) {
+        warnings.push('Config file does not exist. Run agentbell init.');
+        textDetails.push('config readable: no');
+    }
+    else {
+        textDetails.push('config readable: yes');
+    }
+    try {
+        const loaded = await loadConfig(configPathOption);
+        report.provider = loaded.config.provider;
+        textDetails.push(`provider: ${loaded.config.provider}`);
+        textDetails.push(`provider supported: ${loaded.config.provider === 'ntfy' ? 'yes' : 'no'}`);
+        textDetails.push(`ntfy server: ${loaded.config.ntfy.server}`);
+        textDetails.push(`ntfy topic present: ${loaded.config.ntfy.topic.trim() ? 'yes' : 'no'}`);
+        textDetails.push(`ntfy topic masked: ${maskSecret(loaded.config.ntfy.topic)}`);
+        if (!loaded.config.ntfy.topic.trim()) {
+            errors.push('ntfy topic is empty.');
+        }
+        const reachability = await canAccess(loaded.config.ntfy.server);
+        report.ntfyServerReachable = reachability.reachable;
+        textDetails.push(`ntfy server access: ${reachability.detail}`);
+        if (!reachability.reachable) {
+            warnings.push(`ntfy server is not reachable: ${reachability.detail}`);
+        }
+    }
+    catch (error) {
+        errors.push(`config valid: no (${error.message})`);
+        textDetails.push(`config valid: no (${error.message})`);
+    }
+    if (!report.localNotificationSupport.supported) {
+        warnings.push(`local desktop notification unsupported: ${report.localNotificationSupport.reason}`);
+    }
+    return {
+        ...report,
+        textDetails
+    };
+}
+export async function runDoctor(options) {
+    const report = await buildDoctorReport(options.config);
+    if (options.json) {
+        const jsonReport = { ...report };
+        delete jsonReport.textDetails;
+        logger.info(JSON.stringify(jsonReport, null, 2));
+        return;
+    }
+    const lines = ['AgentBell doctor', '================'];
+    lines.push(`platform: ${report.platform} ${os.release()}`);
+    lines.push(`arch: ${report.arch}`);
+    lines.push(`hostname: ${report.hostname}`);
+    lines.push(`username: ${report.username}`);
+    lines.push(`cwd: ${report.cwd}`);
+    lines.push(`node: ${report.nodeVersion}`);
+    lines.push(`executable path: ${report.executablePath}`);
+    lines.push(`cli invocation for hooks: ${currentCliInvocation()}`);
+    lines.push(`config path: ${report.configPath}`);
+    lines.push(...report.textDetails);
+    lines.push(`local notification support: ${report.localNotificationSupport.supported
+        ? `yes (${report.localNotificationSupport.method})`
+        : `no (${report.localNotificationSupport.reason})`}`);
+    lines.push('');
+    lines.push('Recommended hook command examples:');
+    for (const target of report.hookTargets) {
+        lines.push(`- ${target.target}:`);
+        lines.push(`  ${target.command}`);
+    }
+    if (report.warnings.length > 0) {
+        lines.push('');
+        lines.push('Warnings:');
+        for (const warning of report.warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    if (report.errors.length > 0) {
+        lines.push('');
+        lines.push('Errors:');
+        for (const error of report.errors) {
+            lines.push(`- ${error}`);
+        }
+    }
+    logger.info(lines.join('\n'));
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+export declare function runInit(options: {
+    config?: string;
+}): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,92 @@
+import { createInterface } from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { agentBellConfigSchema, writeConfig } from '../config.js';
+import { logger } from '../utils/logger.js';
+import { runInitHooks } from './initHooks.js';
+function yes(value, defaultValue) {
+    const normalized = value.trim().toLowerCase();
+    if (!normalized) {
+        return defaultValue;
+    }
+    return ['y', 'yes', 'true', '1'].includes(normalized);
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of input) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+async function createQuestioner() {
+    if (input.isTTY) {
+        const rl = createInterface({ input, output });
+        return {
+            question: (prompt) => rl.question(prompt),
+            close: () => rl.close()
+        };
+    }
+    const answers = (await readStdin()).split(/\r?\n/);
+    let index = 0;
+    return {
+        async question(prompt) {
+            output.write(prompt);
+            const answer = answers[index] ?? '';
+            index += 1;
+            output.write(`${answer}\n`);
+            return answer;
+        },
+        close: () => undefined
+    };
+}
+export async function runInit(options) {
+    const rl = await createQuestioner();
+    try {
+        const provider = (await rl.question('Notification provider [ntfy]: ')).trim() || 'ntfy';
+        if (provider !== 'ntfy') {
+            throw new Error('Only ntfy is supported in this MVP.');
+        }
+        const server = (await rl.question('ntfy server [https://ntfy.sh]: ')).trim() || 'https://ntfy.sh';
+        const topic = (await rl.question('ntfy topic (use a long random secret): ')).trim();
+        if (!topic) {
+            throw new Error('ntfy topic is required.');
+        }
+        const localEnabled = yes(await rl.question('Enable local desktop notification too? [y/N]: '), false);
+        const includeHostname = yes(await rl.question('Include hostname in notifications? [Y/n]: '), true);
+        const includeCwd = yes(await rl.question('Include cwd in notifications? [Y/n]: '), true);
+        const includeTimestamp = yes(await rl.question('Include timestamp in notifications? [Y/n]: '), true);
+        const config = agentBellConfigSchema.parse({
+            provider: 'ntfy',
+            ntfy: {
+                server,
+                topic,
+                priority: 'high',
+                tags: ['computer']
+            },
+            localNotification: {
+                enabled: localEnabled
+            },
+            includeContext: {
+                hostname: includeHostname,
+                cwd: includeCwd,
+                timestamp: includeTimestamp
+            }
+        });
+        const configPath = await writeConfig(config, options.config);
+        logger.info(`Config written: ${configPath}`);
+        if (yes(await rl.question('Generate hook templates now? [y/N]: '), false)) {
+            const target = (await rl.question('Hook target (claude-code/codex/vscode-agent/all) [all]: ')).trim() ||
+                'all';
+            if (!['claude-code', 'codex', 'vscode-agent', 'all'].includes(target)) {
+                throw new Error(`Invalid hook target: ${target}`);
+            }
+            await runInitHooks({ target });
+        }
+        else {
+            logger.info('Next: run agentbell test, then agentbell init-hooks --target codex');
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/initHooks.d.ts

@@ -0,0 +1,9 @@
+import type { HookInstallResult, HookPreviewResult } from '../types.js';
+export type HookTarget = 'claude-code' | 'codex' | 'vscode-agent' | 'all';
+export declare function mergeJson(base: unknown, addition: unknown): unknown;
+export declare function installHookTarget(target: Exclude<HookTarget, 'all'>): Promise<HookInstallResult>;
+export declare function previewHookTarget(target: Exclude<HookTarget, 'all'>): Promise<HookPreviewResult>;
+export declare function runInitHooks(options: {
+    target: HookTarget;
+    dryRun?: boolean;
+}): Promise<void>;