mattermost-claude-code 0.3.4 → 0.4.0

package/dist/config.d.ts

@@ -1,3 +1,14 @@
+/** Check if any .env config file exists */
+export declare function configExists(): boolean;
+/** CLI arguments that can override config */
+export interface CliArgs {
+    url?: string;
+    token?: string;
+    channel?: string;
+    botName?: string;
+    allowedUsers?: string;
+    skipPermissions?: boolean;
+}
 export interface Config {
     mattermost: {
         url: string;
@@ -8,4 +19,4 @@ export interface Config {
     allowedUsers: string[];
     skipPermissions: boolean;
 }
-export declare function loadConfig(): Config;
+export declare function loadConfig(cliArgs?: CliArgs): Config;

package/dist/config.js

@@ -3,17 +3,17 @@ import { resolve } from 'path';
 import { existsSync } from 'fs';
 import { homedir } from 'os';
 let envLoaded = false;
+// Paths to search for .env files (in order of priority)
+const ENV_PATHS = [
+    resolve(process.cwd(), '.env'), // Current directory
+    resolve(homedir(), '.config', 'mm-claude', '.env'), // ~/.config/mm-claude/.env
+    resolve(homedir(), '.mm-claude.env'), // ~/.mm-claude.env
+];
 function loadEnv() {
     if (envLoaded)
         return;
     envLoaded = true;
-    // Load .env file from multiple locations (in order of priority)
-    const envPaths = [
-        resolve(process.cwd(), '.env'), // Current directory
-        resolve(homedir(), '.config', 'mm-claude', '.env'), // ~/.config/mm-claude/.env
-        resolve(homedir(), '.mm-claude.env'), // ~/.mm-claude.env
-    ];
-    for (const envPath of envPaths) {
+    for (const envPath of ENV_PATHS) {
         if (existsSync(envPath)) {
             if (process.env.DEBUG === '1' || process.argv.includes('--debug')) {
                 console.log(`  [config] Loading from: ${envPath}`);
@@ -23,28 +23,41 @@ function loadEnv() {
         }
     }
 }
-function requireEnv(name) {
-    const value = process.env[name];
+/** Check if any .env config file exists */
+export function configExists() {
+    return ENV_PATHS.some(p => existsSync(p));
+}
+function getRequired(cliValue, envName, name) {
+    const value = cliValue || process.env[envName];
     if (!value) {
-        throw new Error(`Missing required environment variable: ${name}`);
+        throw new Error(`Missing required config: ${name}. Set ${envName} in .env or use --${name.toLowerCase().replace(/ /g, '-')} flag.`);
     }
     return value;
 }
-export function loadConfig() {
+export function loadConfig(cliArgs) {
     loadEnv();
+    // CLI args take priority over env vars
+    const url = getRequired(cliArgs?.url, 'MATTERMOST_URL', 'url');
+    const token = getRequired(cliArgs?.token, 'MATTERMOST_TOKEN', 'token');
+    const channelId = getRequired(cliArgs?.channel, 'MATTERMOST_CHANNEL_ID', 'channel');
+    const botName = cliArgs?.botName || process.env.MATTERMOST_BOT_NAME || 'claude-code';
+    const allowedUsersStr = cliArgs?.allowedUsers || process.env.ALLOWED_USERS || '';
+    const allowedUsers = allowedUsersStr
+        .split(',')
+        .map(u => u.trim())
+        .filter(u => u.length > 0);
+    // CLI --skip-permissions, env SKIP_PERMISSIONS=true, or legacy flag
+    const skipPermissions = cliArgs?.skipPermissions ||
+        process.env.SKIP_PERMISSIONS === 'true' ||
+        process.argv.includes('--dangerously-skip-permissions');
     return {
         mattermost: {
-            url: requireEnv('MATTERMOST_URL').replace(/\/$/, ''), // Remove trailing slash
-            token: requireEnv('MATTERMOST_TOKEN'),
-            channelId: requireEnv('MATTERMOST_CHANNEL_ID'),
-            botName: process.env.MATTERMOST_BOT_NAME || 'claude-code',
+            url: url.replace(/\/$/, ''), // Remove trailing slash
+            token,
+            channelId,
+            botName,
         },
-        allowedUsers: (process.env.ALLOWED_USERS || '')
-            .split(',')
-            .map(u => u.trim())
-            .filter(u => u.length > 0),
-        // SKIP_PERMISSIONS=true or --dangerously-skip-permissions flag
-        skipPermissions: process.env.SKIP_PERMISSIONS === 'true' ||
-            process.argv.includes('--dangerously-skip-permissions'),
+        allowedUsers,
+        skipPermissions,
     };
 }

package/dist/index.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
-import { loadConfig } from './config.js';
+import { program } from 'commander';
+import { loadConfig, configExists } from './config.js';
+import { runOnboarding } from './onboarding.js';
 import { MattermostClient } from './mattermost/client.js';
 import { SessionManager } from './claude/session.js';
 import { readFileSync } from 'fs';
@@ -10,19 +12,44 @@ const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'u
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
 const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+// Define CLI options
+program
+    .name('mm-claude')
+    .version(pkg.version)
+    .description('Share Claude Code sessions in Mattermost')
+    .option('--url <url>', 'Mattermost server URL')
+    .option('--token <token>', 'Mattermost bot token')
+    .option('--channel <id>', 'Mattermost channel ID')
+    .option('--bot-name <name>', 'Bot mention name (default: claude-code)')
+    .option('--allowed-users <users>', 'Comma-separated allowed usernames')
+    .option('--skip-permissions', 'Skip interactive permission prompts')
+    .option('--debug', 'Enable debug logging')
+    .parse();
+const opts = program.opts();
+// Check if required args are provided via CLI
+function hasRequiredCliArgs(args) {
+    return !!(args.url && args.token && args.channel);
+}
 async function main() {
-    if (process.argv.includes('--version') || process.argv.includes('-v')) {
-        console.log(pkg.version);
-        process.exit(0);
+    // Set debug mode from CLI flag
+    if (opts.debug) {
+        process.env.DEBUG = '1';
     }
-    if (process.argv.includes('--help') || process.argv.includes('-h')) {
-        console.log(`mm-claude v${pkg.version} - Share Claude Code sessions in Mattermost
-
-Usage: cd /your/project && mm-claude`);
-        process.exit(0);
+    // Build CLI args object
+    const cliArgs = {
+        url: opts.url,
+        token: opts.token,
+        channel: opts.channel,
+        botName: opts.botName,
+        allowedUsers: opts.allowedUsers,
+        skipPermissions: opts.skipPermissions,
+    };
+    // Check if we need onboarding
+    if (!configExists() && !hasRequiredCliArgs(opts)) {
+        await runOnboarding();
     }
     const workingDir = process.cwd();
-    const config = loadConfig();
+    const config = loadConfig(cliArgs);
     // Nice startup banner
     console.log('');
     console.log(bold(`  🤖 mm-claude v${pkg.version}`));

package/dist/onboarding.d.ts

@@ -0,0 +1 @@
+export declare function runOnboarding(): Promise<void>;

package/dist/onboarding.js

@@ -0,0 +1,117 @@
+import prompts from 'prompts';
+import { writeFileSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { resolve } from 'path';
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+export async function runOnboarding() {
+    console.log('');
+    console.log(bold('  Welcome to mm-claude!'));
+    console.log(dim('  ─────────────────────────────────'));
+    console.log('');
+    console.log('  No configuration found. Let\'s set things up.');
+    console.log('');
+    console.log(dim('  You\'ll need:'));
+    console.log(dim('  • A Mattermost bot account with a token'));
+    console.log(dim('  • A channel ID where the bot will listen'));
+    console.log('');
+    // Handle Ctrl+C gracefully
+    prompts.override({});
+    const onCancel = () => {
+        console.log('');
+        console.log(dim('  Setup cancelled.'));
+        process.exit(0);
+    };
+    const response = await prompts([
+        {
+            type: 'text',
+            name: 'url',
+            message: 'Mattermost URL',
+            initial: 'https://your-mattermost-server.com',
+            validate: (v) => v.startsWith('http') ? true : 'URL must start with http:// or https://',
+        },
+        {
+            type: 'password',
+            name: 'token',
+            message: 'Bot token',
+            hint: 'Create at: Integrations > Bot Accounts > Add Bot Account',
+            validate: (v) => v.length > 0 ? true : 'Token is required',
+        },
+        {
+            type: 'text',
+            name: 'channelId',
+            message: 'Channel ID',
+            hint: 'Click channel name > View Info > copy ID from URL',
+            validate: (v) => v.length > 0 ? true : 'Channel ID is required',
+        },
+        {
+            type: 'text',
+            name: 'botName',
+            message: 'Bot mention name',
+            initial: 'claude-code',
+            hint: 'Users will @mention this name',
+        },
+        {
+            type: 'text',
+            name: 'allowedUsers',
+            message: 'Allowed usernames',
+            initial: '',
+            hint: 'Comma-separated, or empty for all users',
+        },
+        {
+            type: 'confirm',
+            name: 'skipPermissions',
+            message: 'Skip permission prompts?',
+            initial: true,
+            hint: 'If no, you\'ll approve each action via emoji reactions',
+        },
+    ], { onCancel });
+    // Check if user cancelled
+    if (!response.url || !response.token || !response.channelId) {
+        console.log('');
+        console.log(dim('  Setup incomplete. Run mm-claude again to retry.'));
+        process.exit(1);
+    }
+    // Build .env content
+    const envContent = `# mm-claude configuration
+# Generated by mm-claude onboarding
+
+# Mattermost server URL
+MATTERMOST_URL=${response.url}
+
+# Bot token (from Integrations > Bot Accounts)
+MATTERMOST_TOKEN=${response.token}
+
+# Channel ID where the bot listens
+MATTERMOST_CHANNEL_ID=${response.channelId}
+
+# Bot mention name (users @mention this)
+MATTERMOST_BOT_NAME=${response.botName || 'claude-code'}
+
+# Allowed usernames (comma-separated, empty = all users)
+ALLOWED_USERS=${response.allowedUsers || ''}
+
+# Skip permission prompts (true = auto-approve, false = require emoji approval)
+SKIP_PERMISSIONS=${response.skipPermissions ? 'true' : 'false'}
+`;
+    // Save to ~/.config/mm-claude/.env
+    const configDir = resolve(homedir(), '.config', 'mm-claude');
+    const envPath = resolve(configDir, '.env');
+    try {
+        mkdirSync(configDir, { recursive: true });
+        writeFileSync(envPath, envContent, { mode: 0o600 }); // Secure permissions
+    }
+    catch (err) {
+        console.error('');
+        console.error(`  Failed to save config: ${err}`);
+        process.exit(1);
+    }
+    console.log('');
+    console.log(green('  ✓ Configuration saved!'));
+    console.log(dim(`    ${envPath}`));
+    console.log('');
+    console.log(dim('  Starting mm-claude...'));
+    console.log('');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mattermost-claude-code",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "Share Claude Code sessions live in a Mattermost channel with interactive features",
   "main": "dist/index.js",
   "type": "module",
@@ -41,12 +41,15 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
+    "commander": "^14.0.2",
     "dotenv": "^16.4.7",
+    "prompts": "^2.4.2",
     "ws": "^8.18.0",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
+    "@types/prompts": "^2.4.9",
     "@types/ws": "^8.5.13",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2"