afk-code 0.1.4 → 0.2.0

package/README.md

@@ -2,29 +2,38 @@
 
 Monitor and interact with Claude Code sessions from Slack, Discord, or Telegram. Respond from your phone while AFK.
 
-![square-image](https://github.com/user-attachments/assets/83083b63-9ca2-4ef0-b83d-fcc51bd2fff9)
+<img src="https://github.com/user-attachments/assets/83083b63-9ca2-4ef0-b83d-fcc51bd2fff9" alt="AFK Code iPhone Slack screenshot" width="400">
 
-## Quick Start (Slack)
+## Client Comparison
+
+Telegram and Discord are recommended.
+
+| | Telegram | Discord | Slack |
+|---|---|---|---|
+| Siri integration | Receive & Send | Receive only | Receive only |
+| Multi-session support | One at a time (switchable) | Yes | Yes |
+| Permissions required | Personal | Personal | Admin |
+
+## Quick Start (Telegram)
 
 ```bash
-# 1. Create a Slack app at https://api.slack.com/apps
-#    Click "Create New App" → "From manifest" → paste slack-manifest.json
+# 1. Create a bot with @BotFather on Telegram
+#    - Send /newbot and follow the prompts
+#    - Copy the bot token
 
-# 2. Install to your workspace and get credentials:
-#    - Bot Token (xoxb-...) from OAuth & Permissions
-#    - App Token (xapp-...) from Basic Information → App-Level Tokens (needs connections:write)
-#    - Your User ID from your Slack profile → "..." → Copy member ID
+# 2. Get your Chat ID
+#    - Message your bot, then visit:
+#    - https://api.telegram.org/bot<TOKEN>/getUpdates
+#    - Find "chat":{"id":YOUR_CHAT_ID}
 
 # 3. Configure and run
-npx afk-code slack setup   # Enter your credentials
-npx afk-code slack         # Start the bot
+npx afk-code telegram setup   # Enter your credentials
+npx afk-code telegram         # Start the bot
 
 # 4. In another terminal, start a monitored Claude session
-npx afk-code run -- claude
+npx afk-code claude
 ```
 
-A new channel is created for each session. Messages relay bidirectionally.
-
 ## Quick Start (Discord)
 
 ```bash
@@ -42,39 +51,40 @@ npx afk-code discord setup   # Enter your credentials
 npx afk-code discord         # Start the bot
 
 # 4. In another terminal, start a monitored Claude session
-npx afk-code run -- claude
+npx afk-code claude
 ```
 
-## Quick Start (Telegram)
+## Quick Start (Slack)
 
 ```bash
-# 1. Create a bot with @BotFather on Telegram
-#    - Send /newbot and follow the prompts
-#    - Copy the bot token
+# 1. Create a Slack app at https://api.slack.com/apps
+#    Click "Create New App" → "From manifest" → paste slack-manifest.json
 
-# 2. Get your Chat ID
-#    - Message your bot, then visit:
-#    - https://api.telegram.org/bot<TOKEN>/getUpdates
-#    - Find "chat":{"id":YOUR_CHAT_ID}
+# 2. Install to your workspace and get credentials:
+#    - Bot Token (xoxb-...) from OAuth & Permissions
+#    - App Token (xapp-...) from Basic Information → App-Level Tokens (needs connections:write)
+#    - Your User ID from your Slack profile → "..." → Copy member ID
 
 # 3. Configure and run
-npx afk-code telegram setup   # Enter your credentials
-npx afk-code telegram         # Start the bot
+npx afk-code slack setup   # Enter your credentials
+npx afk-code slack         # Start the bot
 
 # 4. In another terminal, start a monitored Claude session
-npx afk-code run -- claude
+npx afk-code claude
 ```
 
+A new channel is created for each session. Messages relay bidirectionally.
+
 ## Commands
 
 ```
-afk-code slack setup        Configure Slack credentials
-afk-code slack              Run the Slack bot
-afk-code discord setup      Configure Discord credentials
-afk-code discord            Run the Discord bot
 afk-code telegram setup     Configure Telegram credentials
 afk-code telegram           Run the Telegram bot
-afk-code run -- <command>   Start a monitored session
+afk-code discord setup      Configure Discord credentials
+afk-code discord            Run the Discord bot
+afk-code slack setup        Configure Slack credentials
+afk-code slack              Run the Slack bot
+afk-code <command> [args]   Start a monitored session
 afk-code help               Show help
 ```
 
@@ -103,7 +113,7 @@ npx afk-code <command>
 git clone https://github.com/clharman/afk-code.git
 cd afk-code && npm install
 npm run dev -- slack
-npm run dev -- run -- claude
+npm run dev -- claude
 ```
 
 Requires Node.js 18+.
@@ -111,7 +121,7 @@ Requires Node.js 18+.
 ## How It Works
 
 1. `afk-code slack`, `afk-code discord`, or `afk-code telegram` starts a bot that listens for sessions
-2. `afk-code run -- claude` spawns Claude in a PTY and connects to the bot via Unix socket
+2. `afk-code claude` spawns Claude in a PTY and connects to the bot via Unix socket
 3. The bot watches Claude's JSONL files for messages and relays them to chat
 4. Messages you send in chat are forwarded to the terminal
 

package/dist/cli/index.js

@@ -1597,13 +1597,18 @@ function createTelegramApp(config) {
     }
     processingQueue = false;
   }
-  async function sendMessage(text, parseMode = "Markdown") {
+  async function sendMessage(text, parseMode = "Markdown", options) {
     messageQueue.push(async () => {
       try {
-        await bot.api.sendMessage(config.chatId, text, { parse_mode: parseMode });
+        await bot.api.sendMessage(config.chatId, text, {
+          parse_mode: parseMode,
+          disable_notification: options?.disable_notification
+        });
       } catch (err) {
         if (parseMode && err.message?.includes("parse")) {
-          await bot.api.sendMessage(config.chatId, text);
+          await bot.api.sendMessage(config.chatId, text, {
+            disable_notification: options?.disable_notification
+          });
         } else {
           throw err;
         }
@@ -1611,13 +1616,11 @@ function createTelegramApp(config) {
     });
     processQueue();
   }
-  async function sendChunkedMessage(text, prefix) {
+  async function sendChunkedMessage(text, prefix, options) {
     const chunks = chunkMessage(text, MAX_MESSAGE_LENGTH);
     for (let i = 0; i < chunks.length; i++) {
-      const chunk = prefix && i === 0 ? `${prefix}
-
-${chunks[i]}` : chunks[i];
-      await sendMessage(chunk);
+      const chunk = prefix && i === 0 ? `${prefix} ${chunks[i]}` : chunks[i];
+      await sendMessage(chunk, "Markdown", options);
     }
   }
   const sessionManager = new SessionManager({
@@ -1627,17 +1630,20 @@ ${chunks[i]}` : chunks[i];
         sessionName: session.name,
         lastActivity: /* @__PURE__ */ new Date()
       });
+      const parts = session.name.split(" ");
+      const cmd = parts[0];
+      const args2 = parts.slice(1).map((a) => a.replace(/^-+/, ""));
+      const sessionLabel = args2.length > 0 ? `${cmd} (${args2.join(", ")})` : cmd;
       await sendMessage(
-        `*[${session.name}]* ${formatSessionStatus(session.status)}
-Session started
-\`${session.cwd}\``
+        `Session started: ${sessionLabel}
+Directory: \`${session.cwd}\``
       );
     },
     onSessionEnd: async (sessionId) => {
       const tracking = activeSessions.get(sessionId);
       const name = tracking?.sessionName || sessionId;
       activeSessions.delete(sessionId);
-      await sendMessage(`*[${name}]* Session ended`);
+      await sendMessage(`Session ended: ${name}`);
     },
     onSessionUpdate: async (sessionId, name) => {
       const tracking = activeSessions.get(sessionId);
@@ -1662,16 +1668,16 @@ Session started
           telegramSentMessages.delete(contentKey);
           return;
         }
-        await sendChunkedMessage(content, `*[${tracking.sessionName}]* *User:*`);
+        await sendChunkedMessage(content, `_User (terminal):_`, { disable_notification: true });
       } else {
-        await sendChunkedMessage(content, `*[${tracking.sessionName}]* *Claude:*`);
+        await sendChunkedMessage(content, `_Claude Code:_`);
       }
     },
     onTodos: async (sessionId, todos) => {
       const tracking = activeSessions.get(sessionId);
       if (!tracking || todos.length === 0) return;
       const todosText = formatTodos(todos);
-      await sendMessage(`*[${tracking.sessionName}]* *Tasks:*
+      await sendMessage(`_Claude Code:_ *Tasks:*
 ${todosText}`);
     },
     onToolCall: async (_sessionId, _tool) => {
@@ -1682,7 +1688,7 @@ ${todosText}`);
       const tracking = activeSessions.get(sessionId);
       if (!tracking) return;
       const status = inPlanMode ? "Planning mode - Claude is designing a solution" : "Execution mode - Claude is implementing";
-      await sendMessage(`*[${tracking.sessionName}]* ${status}`);
+      await sendMessage(`_Claude Code:_ ${status}`);
     }
   });
   function getCurrentSession() {
@@ -2504,30 +2510,29 @@ async function main() {
 AFK Code - Monitor Claude Code sessions from Slack/Discord/Telegram
 
 Commands:
-  slack              Run the Slack bot
-  slack setup        Configure Slack integration
-  discord            Run the Discord bot
-  discord setup      Configure Discord integration
   telegram           Run the Telegram bot
   telegram setup     Configure Telegram integration
-  run -- <command>   Start a monitored session
+  discord            Run the Discord bot
+  discord setup      Configure Discord integration
+  slack              Run the Slack bot
+  slack setup        Configure Slack integration
+  <command> [args]   Start a monitored session
   help               Show this help message
 
 Examples:
-  afk-code slack setup      # First-time Slack configuration
-  afk-code slack            # Start the Slack bot
-  afk-code discord setup    # First-time Discord configuration
-  afk-code discord          # Start the Discord bot
   afk-code telegram setup   # First-time Telegram configuration
   afk-code telegram         # Start the Telegram bot
-  afk-code run -- claude    # Start a Claude Code session
+  afk-code discord setup    # First-time Discord configuration
+  afk-code discord          # Start the Discord bot
+  afk-code slack setup      # First-time Slack configuration
+  afk-code slack            # Start the Slack bot
+  afk-code claude           # Start a Claude Code session
 `);
       break;
     }
     default: {
-      console.error(`Unknown command: ${command}`);
-      console.error('Run "afk-code help" for usage');
-      process.exit(1);
+      await run(args);
+      break;
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afk-code",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Monitor and interact with Claude Code sessions from Slack/Discord/Telegram",
   "author": "Colin Harman",
   "repository": {
@@ -36,7 +36,7 @@
     "cli"
   ],
   "license": "MIT",
-  "dependencies": {
+"dependencies": {
     "@slack/bolt": "^4.6.0",
     "discord.js": "^14.25.1",
     "grammy": "^1.35.0",