kimaki 0.4.36 → 0.4.37

package/dist/channel-management.js

@@ -57,11 +57,11 @@ export async function createProjectChannels({ guild, projectDirectory, appId, bo
         parent: kimakiAudioCategory,
     });
     getDatabase()
-        .prepare('INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)')
-        .run(textChannel.id, projectDirectory, 'text');
+        .prepare('INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)')
+        .run(textChannel.id, projectDirectory, 'text', appId);
     getDatabase()
-        .prepare('INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)')
-        .run(voiceChannel.id, projectDirectory, 'voice');
+        .prepare('INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)')
+        .run(voiceChannel.id, projectDirectory, 'voice', appId);
     return {
         textChannelId: textChannel.id,
         voiceChannelId: voiceChannel.id,

package/dist/cli.js

@@ -484,10 +484,10 @@ async function run({ restart, addChannels }) {
     for (const { guild, channels } of kimakiChannels) {
         for (const channel of channels) {
             if (channel.kimakiDirectory) {
-                db.prepare('INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)').run(channel.id, channel.kimakiDirectory, 'text');
+                db.prepare('INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)').run(channel.id, channel.kimakiDirectory, 'text', channel.kimakiApp || null);
                 const voiceChannel = guild.channels.cache.find((ch) => ch.type === ChannelType.GuildVoice && ch.name === channel.name);
                 if (voiceChannel) {
-                    db.prepare('INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)').run(voiceChannel.id, channel.kimakiDirectory, 'voice');
+                    db.prepare('INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)').run(voiceChannel.id, channel.kimakiDirectory, 'voice', channel.kimakiApp || null);
                 }
             }
         }
@@ -749,17 +749,30 @@ cli
 // Magic prefix used to identify bot-initiated sessions.
 // The running bot will recognize this prefix and start a session.
 const BOT_SESSION_PREFIX = '🤖 **Bot-initiated session**';
+// Notify-only prefix - bot won't start a session, just creates thread for notifications.
+// Reply to the thread to start a session with the notification as context.
+const BOT_NOTIFY_PREFIX = '📢 **Notification**';
 cli
-    .command('start-session', 'Start a new session in a Discord channel (creates thread, bot handles the rest)')
+    .command('send', 'Send a message to Discord channel, creating a thread. Use --notify-only to skip AI session.')
+    .alias('start-session') // backwards compatibility
     .option('-c, --channel <channelId>', 'Discord channel ID')
     .option('-d, --project <path>', 'Project directory (alternative to --channel)')
-    .option('-p, --prompt <prompt>', 'Initial prompt for the session')
+    .option('-p, --prompt <prompt>', 'Message content')
     .option('-n, --name [name]', 'Thread name (optional, defaults to prompt preview)')
     .option('-a, --app-id [appId]', 'Bot application ID (required if no local database)')
+    .option('--notify-only', 'Create notification thread without starting AI session')
     .action(async (options) => {
     try {
-        let { channel: channelId, prompt, name, appId: optionAppId } = options;
+        let { channel: channelId, prompt, name, appId: optionAppId, notifyOnly } = options;
         const { project: projectPath } = options;
+        // Get raw channel ID from argv to prevent JS number precision loss on large Discord IDs
+        // cac parses large numbers and loses precision, so we extract the original string value
+        if (channelId) {
+            const channelArgIndex = process.argv.findIndex((arg) => arg === '--channel' || arg === '-c');
+            if (channelArgIndex !== -1 && process.argv[channelArgIndex + 1]) {
+                channelId = process.argv[channelArgIndex + 1];
+            }
+        }
         if (!channelId && !projectPath) {
             cliLogger.error('Either --channel or --project is required');
             process.exit(EXIT_NO_RESTART);
@@ -818,15 +831,38 @@ cli
                 process.exit(EXIT_NO_RESTART);
             }
             s.start('Looking up channel for project...');
-            // Check if channel already exists for this directory
+            // Check if channel already exists for this directory or a parent directory
+            // This allows running from subfolders of a registered project
             try {
                 const db = getDatabase();
-                const existingChannel = db
-                    .prepare('SELECT channel_id FROM channel_directories WHERE directory = ? AND channel_type = ?')
-                    .get(absolutePath, 'text');
+                // Helper to find channel for a path (prefers current bot's channel)
+                const findChannelForPath = (dirPath) => {
+                    const withAppId = db
+                        .prepare('SELECT channel_id, directory FROM channel_directories WHERE directory = ? AND channel_type = ? AND app_id = ?')
+                        .get(dirPath, 'text', appId);
+                    if (withAppId)
+                        return withAppId;
+                    return db
+                        .prepare('SELECT channel_id, directory FROM channel_directories WHERE directory = ? AND channel_type = ?')
+                        .get(dirPath, 'text');
+                };
+                // Try exact match first, then walk up parent directories
+                let existingChannel;
+                let searchPath = absolutePath;
+                while (searchPath !== path.dirname(searchPath)) {
+                    existingChannel = findChannelForPath(searchPath);
+                    if (existingChannel)
+                        break;
+                    searchPath = path.dirname(searchPath);
+                }
                 if (existingChannel) {
                     channelId = existingChannel.channel_id;
-                    s.message(`Found existing channel: ${channelId}`);
+                    if (existingChannel.directory !== absolutePath) {
+                        s.message(`Found parent project channel: ${existingChannel.directory}`);
+                    }
+                    else {
+                        s.message(`Found existing channel: ${channelId}`);
+                    }
                 }
                 else {
                     // Need to create a new channel
@@ -846,10 +882,10 @@ cli
                     });
                     // Get guild from existing channels or first available
                     const guild = await (async () => {
-                        // Try to find a guild from existing channels
+                        // Try to find a guild from existing channels belonging to this bot
                         const existingChannelRow = db
-                            .prepare('SELECT channel_id FROM channel_directories ORDER BY created_at DESC LIMIT 1')
-                            .get();
+                            .prepare('SELECT channel_id FROM channel_directories WHERE app_id = ? ORDER BY created_at DESC LIMIT 1')
+                            .get(appId);
                         if (existingChannelRow) {
                             try {
                                 const ch = await client.channels.fetch(existingChannelRow.channel_id);
@@ -861,7 +897,7 @@ cli
                                 // Channel might be deleted, continue
                             }
                         }
-                        // Fall back to first guild
+                        // Fall back to first guild the bot is in
                         const firstGuild = client.guilds.cache.first();
                         if (!firstGuild) {
                             throw new Error('No guild found. Add the bot to a server first.');
@@ -918,7 +954,8 @@ cli
         }
         s.message('Creating starter message...');
         // Create starter message with magic prefix
-        // The full prompt goes in the message so the bot can read it
+        // BOT_SESSION_PREFIX triggers AI session, BOT_NOTIFY_PREFIX is notification-only
+        const messagePrefix = notifyOnly ? BOT_NOTIFY_PREFIX : BOT_SESSION_PREFIX;
         const starterMessageResponse = await fetch(`https://discord.com/api/v10/channels/${channelId}/messages`, {
             method: 'POST',
             headers: {
@@ -926,7 +963,7 @@ cli
                 'Content-Type': 'application/json',
             },
             body: JSON.stringify({
-                content: `${BOT_SESSION_PREFIX}\n${prompt}`,
+                content: `${messagePrefix}\n${prompt}`,
             }),
         });
         if (!starterMessageResponse.ok) {
@@ -957,7 +994,10 @@ cli
         const threadData = (await threadResponse.json());
         s.stop('Thread created!');
         const threadUrl = `https://discord.com/channels/${channelData.guild_id}/${threadData.id}`;
-        note(`Thread: ${threadData.name}\nDirectory: ${projectDirectory}\n\nThe running bot will pick this up and start the session.\n\nURL: ${threadUrl}`, '✅ Thread Created');
+        const successMessage = notifyOnly
+            ? `Thread: ${threadData.name}\nDirectory: ${projectDirectory}\n\nNotification created. Reply to start a session.\n\nURL: ${threadUrl}`
+            : `Thread: ${threadData.name}\nDirectory: ${projectDirectory}\n\nThe running bot will pick this up and start the session.\n\nURL: ${threadUrl}`;
+        note(successMessage, '✅ Thread Created');
         console.log(threadUrl);
         process.exit(0);
     }

package/dist/database.js

@@ -50,6 +50,13 @@ export function getDatabase() {
         created_at DATETIME DEFAULT CURRENT_TIMESTAMP
       )
     `);
+        // Migration: add app_id column to channel_directories for multi-bot support
+        try {
+            db.exec(`ALTER TABLE channel_directories ADD COLUMN app_id TEXT`);
+        }
+        catch {
+            // Column already exists, ignore
+        }
         db.exec(`
       CREATE TABLE IF NOT EXISTS bot_api_keys (
         app_id TEXT PRIMARY KEY,

package/dist/discord-bot.js

@@ -119,14 +119,6 @@ export async function startDiscordBot({ token, appId, discordClient, }) {
             if (isThread) {
                 const thread = channel;
                 discordLogger.log(`Message in thread ${thread.name} (${thread.id})`);
-                const row = getDatabase()
-                    .prepare('SELECT session_id FROM thread_sessions WHERE thread_id = ?')
-                    .get(thread.id);
-                if (!row) {
-                    discordLogger.log(`No session found for thread ${thread.id}`);
-                    return;
-                }
-                voiceLogger.log(`[SESSION] Found session ${row.session_id} for thread ${thread.id}`);
                 const parent = thread.parent;
                 let projectDirectory;
                 let channelAppId;
@@ -150,6 +142,37 @@ export async function startDiscordBot({ token, appId, discordClient, }) {
                     });
                     return;
                 }
+                const row = getDatabase()
+                    .prepare('SELECT session_id FROM thread_sessions WHERE thread_id = ?')
+                    .get(thread.id);
+                // No existing session - start a new one (e.g., replying to a notification thread)
+                if (!row) {
+                    discordLogger.log(`No session for thread ${thread.id}, starting new session`);
+                    if (!projectDirectory) {
+                        discordLogger.log(`Cannot start session: no project directory for thread ${thread.id}`);
+                        return;
+                    }
+                    // Include starter message (notification) as context for the session
+                    let prompt = message.content;
+                    const starterMessage = await thread.fetchStarterMessage().catch(() => null);
+                    if (starterMessage?.content) {
+                        // Strip notification prefix if present
+                        const notificationContent = starterMessage.content
+                            .replace(/^📢 \*\*Notification\*\*\n?/, '')
+                            .trim();
+                        if (notificationContent) {
+                            prompt = `Context from notification:\n${notificationContent}\n\nUser request:\n${message.content}`;
+                        }
+                    }
+                    await handleOpencodeSession({
+                        prompt,
+                        thread,
+                        projectDirectory,
+                        channelId: parent?.id || '',
+                    });
+                    return;
+                }
+                voiceLogger.log(`[SESSION] Found session ${row.session_id} for thread ${thread.id}`);
                 let messageContent = message.content || '';
                 let currentSessionContext;
                 let lastSessionContext;
@@ -293,9 +316,9 @@ export async function startDiscordBot({ token, appId, discordClient, }) {
             }
         }
     });
-    // Magic prefix used by `kimaki start-session` CLI command to initiate sessions
+    // Magic prefix used by `kimaki send` CLI command to initiate sessions
     const BOT_SESSION_PREFIX = '🤖 **Bot-initiated session**';
-    // Handle bot-initiated threads created by `kimaki start-session`
+    // Handle bot-initiated threads created by `kimaki send`
     discordClient.on(Events.ThreadCreate, async (thread, newlyCreated) => {
         try {
             if (!newlyCreated) {

package/dist/system-message.js

@@ -28,7 +28,11 @@ ${channelId
 
 To start a new thread/session in this channel programmatically, run:
 
-npx -y kimaki start-session --channel ${channelId} --prompt "your prompt here"
+npx -y kimaki send --channel ${channelId} --prompt "your prompt here"
+
+Use --notify-only to create a notification thread without starting an AI session:
+
+npx -y kimaki send --channel ${channelId} --prompt "User cancelled subscription" --notify-only
 
 This is useful for automation (cron jobs, GitHub webhooks, n8n, etc.)
 `

package/package.json

@@ -2,7 +2,7 @@
   "name": "kimaki",
   "module": "index.ts",
   "type": "module",
-  "version": "0.4.36",
+  "version": "0.4.37",
   "scripts": {
     "dev": "tsx --env-file .env src/cli.ts",
     "prepublishOnly": "pnpm tsc",

package/src/channel-management.ts

@@ -90,15 +90,15 @@ export async function createProjectChannels({
 
   getDatabase()
     .prepare(
-      'INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)',
+      'INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)',
     )
-    .run(textChannel.id, projectDirectory, 'text')
+    .run(textChannel.id, projectDirectory, 'text', appId)
 
   getDatabase()
     .prepare(
-      'INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)',
+      'INSERT OR REPLACE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)',
     )
-    .run(voiceChannel.id, projectDirectory, 'voice')
+    .run(voiceChannel.id, projectDirectory, 'voice', appId)
 
   return {
     textChannelId: textChannel.id,

package/src/cli.ts

@@ -632,8 +632,8 @@ async function run({ restart, addChannels }: CliOptions) {
     for (const channel of channels) {
       if (channel.kimakiDirectory) {
         db.prepare(
-          'INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)',
-        ).run(channel.id, channel.kimakiDirectory, 'text')
+          'INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)',
+        ).run(channel.id, channel.kimakiDirectory, 'text', channel.kimakiApp || null)
 
         const voiceChannel = guild.channels.cache.find(
           (ch) => ch.type === ChannelType.GuildVoice && ch.name === channel.name,
@@ -641,8 +641,8 @@ async function run({ restart, addChannels }: CliOptions) {
 
         if (voiceChannel) {
           db.prepare(
-            'INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type) VALUES (?, ?, ?)',
-          ).run(voiceChannel.id, channel.kimakiDirectory, 'voice')
+            'INSERT OR IGNORE INTO channel_directories (channel_id, directory, channel_type, app_id) VALUES (?, ?, ?, ?)',
+          ).run(voiceChannel.id, channel.kimakiDirectory, 'voice', channel.kimakiApp || null)
         }
       }
     }
@@ -1002,17 +1002,22 @@ cli
 // Magic prefix used to identify bot-initiated sessions.
 // The running bot will recognize this prefix and start a session.
 const BOT_SESSION_PREFIX = '🤖 **Bot-initiated session**'
+// Notify-only prefix - bot won't start a session, just creates thread for notifications.
+// Reply to the thread to start a session with the notification as context.
+const BOT_NOTIFY_PREFIX = '📢 **Notification**'
 
 cli
   .command(
-    'start-session',
-    'Start a new session in a Discord channel (creates thread, bot handles the rest)',
+    'send',
+    'Send a message to Discord channel, creating a thread. Use --notify-only to skip AI session.',
   )
+  .alias('start-session') // backwards compatibility
   .option('-c, --channel <channelId>', 'Discord channel ID')
   .option('-d, --project <path>', 'Project directory (alternative to --channel)')
-  .option('-p, --prompt <prompt>', 'Initial prompt for the session')
+  .option('-p, --prompt <prompt>', 'Message content')
   .option('-n, --name [name]', 'Thread name (optional, defaults to prompt preview)')
   .option('-a, --app-id [appId]', 'Bot application ID (required if no local database)')
+  .option('--notify-only', 'Create notification thread without starting AI session')
   .action(
     async (options: {
       channel?: string
@@ -1020,10 +1025,20 @@ cli
       prompt?: string
       name?: string
       appId?: string
+      notifyOnly?: boolean
     }) => {
       try {
-        let { channel: channelId, prompt, name, appId: optionAppId } = options
+        let { channel: channelId, prompt, name, appId: optionAppId, notifyOnly } = options
         const { project: projectPath } = options
+        
+        // Get raw channel ID from argv to prevent JS number precision loss on large Discord IDs
+        // cac parses large numbers and loses precision, so we extract the original string value
+        if (channelId) {
+          const channelArgIndex = process.argv.findIndex((arg) => arg === '--channel' || arg === '-c')
+          if (channelArgIndex !== -1 && process.argv[channelArgIndex + 1]) {
+            channelId = process.argv[channelArgIndex + 1]
+          }
+        }
 
         if (!channelId && !projectPath) {
           cliLogger.error('Either --channel or --project is required')
@@ -1092,18 +1107,43 @@ cli
 
         s.start('Looking up channel for project...')
 
-        // Check if channel already exists for this directory
+        // Check if channel already exists for this directory or a parent directory
+        // This allows running from subfolders of a registered project
         try {
           const db = getDatabase()
-          const existingChannel = db
-            .prepare(
-              'SELECT channel_id FROM channel_directories WHERE directory = ? AND channel_type = ?',
-            )
-            .get(absolutePath, 'text') as { channel_id: string } | undefined
+          
+          // Helper to find channel for a path (prefers current bot's channel)
+          const findChannelForPath = (dirPath: string): { channel_id: string; directory: string } | undefined => {
+            const withAppId = db
+              .prepare(
+                'SELECT channel_id, directory FROM channel_directories WHERE directory = ? AND channel_type = ? AND app_id = ?',
+              )
+              .get(dirPath, 'text', appId) as { channel_id: string; directory: string } | undefined
+            if (withAppId) return withAppId
+            
+            return db
+              .prepare(
+                'SELECT channel_id, directory FROM channel_directories WHERE directory = ? AND channel_type = ?',
+              )
+              .get(dirPath, 'text') as { channel_id: string; directory: string } | undefined
+          }
+          
+          // Try exact match first, then walk up parent directories
+          let existingChannel: { channel_id: string; directory: string } | undefined
+          let searchPath = absolutePath
+          while (searchPath !== path.dirname(searchPath)) {
+            existingChannel = findChannelForPath(searchPath)
+            if (existingChannel) break
+            searchPath = path.dirname(searchPath)
+          }
 
           if (existingChannel) {
             channelId = existingChannel.channel_id
-            s.message(`Found existing channel: ${channelId}`)
+            if (existingChannel.directory !== absolutePath) {
+              s.message(`Found parent project channel: ${existingChannel.directory}`)
+            } else {
+              s.message(`Found existing channel: ${channelId}`)
+            }
           } else {
             // Need to create a new channel
             s.message('Creating new channel...')
@@ -1128,12 +1168,12 @@ cli
 
             // Get guild from existing channels or first available
             const guild = await (async () => {
-              // Try to find a guild from existing channels
+              // Try to find a guild from existing channels belonging to this bot
               const existingChannelRow = db
                 .prepare(
-                  'SELECT channel_id FROM channel_directories ORDER BY created_at DESC LIMIT 1',
+                  'SELECT channel_id FROM channel_directories WHERE app_id = ? ORDER BY created_at DESC LIMIT 1',
                 )
-                .get() as { channel_id: string } | undefined
+                .get(appId) as { channel_id: string } | undefined
 
               if (existingChannelRow) {
                 try {
@@ -1145,7 +1185,7 @@ cli
                   // Channel might be deleted, continue
                 }
               }
-              // Fall back to first guild
+              // Fall back to first guild the bot is in
               const firstGuild = client.guilds.cache.first()
               if (!firstGuild) {
                 throw new Error('No guild found. Add the bot to a server first.')
@@ -1224,7 +1264,8 @@ cli
       s.message('Creating starter message...')
 
       // Create starter message with magic prefix
-      // The full prompt goes in the message so the bot can read it
+      // BOT_SESSION_PREFIX triggers AI session, BOT_NOTIFY_PREFIX is notification-only
+      const messagePrefix = notifyOnly ? BOT_NOTIFY_PREFIX : BOT_SESSION_PREFIX
       const starterMessageResponse = await fetch(
         `https://discord.com/api/v10/channels/${channelId}/messages`,
         {
@@ -1234,7 +1275,7 @@ cli
             'Content-Type': 'application/json',
           },
           body: JSON.stringify({
-            content: `${BOT_SESSION_PREFIX}\n${prompt}`,
+            content: `${messagePrefix}\n${prompt}`,
           }),
         },
       )
@@ -1278,10 +1319,11 @@ cli
 
       const threadUrl = `https://discord.com/channels/${channelData.guild_id}/${threadData.id}`
 
-      note(
-        `Thread: ${threadData.name}\nDirectory: ${projectDirectory}\n\nThe running bot will pick this up and start the session.\n\nURL: ${threadUrl}`,
-        '✅ Thread Created',
-      )
+      const successMessage = notifyOnly
+        ? `Thread: ${threadData.name}\nDirectory: ${projectDirectory}\n\nNotification created. Reply to start a session.\n\nURL: ${threadUrl}`
+        : `Thread: ${threadData.name}\nDirectory: ${projectDirectory}\n\nThe running bot will pick this up and start the session.\n\nURL: ${threadUrl}`
+
+      note(successMessage, '✅ Thread Created')
 
       console.log(threadUrl)
 

package/src/database.ts

@@ -61,6 +61,13 @@ export function getDatabase(): Database.Database {
       )
     `)
 
+    // Migration: add app_id column to channel_directories for multi-bot support
+    try {
+      db.exec(`ALTER TABLE channel_directories ADD COLUMN app_id TEXT`)
+    } catch {
+      // Column already exists, ignore
+    }
+
     db.exec(`
       CREATE TABLE IF NOT EXISTS bot_api_keys (
         app_id TEXT PRIMARY KEY,

package/src/discord-bot.ts

@@ -187,17 +187,6 @@ export async function startDiscordBot({
         const thread = channel as ThreadChannel
         discordLogger.log(`Message in thread ${thread.name} (${thread.id})`)
 
-        const row = getDatabase()
-          .prepare('SELECT session_id FROM thread_sessions WHERE thread_id = ?')
-          .get(thread.id) as { session_id: string } | undefined
-
-        if (!row) {
-          discordLogger.log(`No session found for thread ${thread.id}`)
-          return
-        }
-
-        voiceLogger.log(`[SESSION] Found session ${row.session_id} for thread ${thread.id}`)
-
         const parent = thread.parent as TextChannel | null
         let projectDirectory: string | undefined
         let channelAppId: string | undefined
@@ -228,6 +217,43 @@ export async function startDiscordBot({
           return
         }
 
+        const row = getDatabase()
+          .prepare('SELECT session_id FROM thread_sessions WHERE thread_id = ?')
+          .get(thread.id) as { session_id: string } | undefined
+
+        // No existing session - start a new one (e.g., replying to a notification thread)
+        if (!row) {
+          discordLogger.log(`No session for thread ${thread.id}, starting new session`)
+          
+          if (!projectDirectory) {
+            discordLogger.log(`Cannot start session: no project directory for thread ${thread.id}`)
+            return
+          }
+
+          // Include starter message (notification) as context for the session
+          let prompt = message.content
+          const starterMessage = await thread.fetchStarterMessage().catch(() => null)
+          if (starterMessage?.content) {
+            // Strip notification prefix if present
+            const notificationContent = starterMessage.content
+              .replace(/^📢 \*\*Notification\*\*\n?/, '')
+              .trim()
+            if (notificationContent) {
+              prompt = `Context from notification:\n${notificationContent}\n\nUser request:\n${message.content}`
+            }
+          }
+
+          await handleOpencodeSession({
+            prompt,
+            thread,
+            projectDirectory,
+            channelId: parent?.id || '',
+          })
+          return
+        }
+
+        voiceLogger.log(`[SESSION] Found session ${row.session_id} for thread ${thread.id}`)
+
         let messageContent = message.content || ''
 
         let currentSessionContext: string | undefined
@@ -393,10 +419,10 @@ export async function startDiscordBot({
     }
   })
 
-  // Magic prefix used by `kimaki start-session` CLI command to initiate sessions
+  // Magic prefix used by `kimaki send` CLI command to initiate sessions
   const BOT_SESSION_PREFIX = '🤖 **Bot-initiated session**'
 
-  // Handle bot-initiated threads created by `kimaki start-session`
+  // Handle bot-initiated threads created by `kimaki send`
   discordClient.on(Events.ThreadCreate, async (thread, newlyCreated) => {
     try {
       if (!newlyCreated) {

package/src/system-message.ts

@@ -36,7 +36,11 @@ ${
 
 To start a new thread/session in this channel programmatically, run:
 
-npx -y kimaki start-session --channel ${channelId} --prompt "your prompt here"
+npx -y kimaki send --channel ${channelId} --prompt "your prompt here"
+
+Use --notify-only to create a notification thread without starting an AI session:
+
+npx -y kimaki send --channel ${channelId} --prompt "User cancelled subscription" --notify-only
 
 This is useful for automation (cron jobs, GitHub webhooks, n8n, etc.)
 `