v0.3.0

Features:
- Add image/GIF upload support for Telegram
- Add loading spinner when starting `afk-code claude`
- Show project directory in Telegram session list (thanks @AnveshJarabani)

Fixes:
- Add `files:write` scope to Slack manifest for image uploads
- Add "Attach Files" permission to Discord setup instructions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: clharman

README.md

@@ -13,6 +13,7 @@ Telegram and Discord are recommended.
 | Siri integration | Receive & Send | Receive only | Receive only |
 | Multi-session support | One at a time (switchable) | Yes | Yes |
 | Permissions required | Personal | Personal | Admin |
+| Image support | Yes | Yes | Yes |
 
 ## Quick Start (Telegram)
 
@@ -41,7 +42,7 @@ npx afk-code claude
 #    - Go to Bot → Reset Token → copy it
 #    - Enable "Message Content Intent"
 #    - Go to OAuth2 → URL Generator → select "bot" scope
-#    - Select permissions: Send Messages, Manage Channels, Read Message History
+#    - Select permissions: Send Messages, Manage Channels, Read Message History, Attach Files
 #    - Open the generated URL to invite the bot
 
 # 2. Get your User ID (enable Developer Mode, right-click your name → Copy User ID)
@@ -75,6 +76,10 @@ npx afk-code claude
 
 A new channel is created for each session. Messages relay bidirectionally.
 
+## Image Support
+
+When Claude references image paths in responses (e.g., `/path/to/screenshot.png`), the bot automatically detects and uploads them to the chat. Supports PNG, JPG, GIF, WebP, and other common formats.
+
 ## Commands
 
 ```
@@ -128,7 +133,8 @@ Requires Node.js 18+.
 ## Limitations
 
 - Does not support plan mode or responding to Claude Code's form-based questions (AskUserQuestion)
-- Does not send tool calls or results
+  - You can bypass this using the `/mode` command or by sending any message
+- Does not send tool calls or results (would encounter rate limits)
 
 ## Disclaimer
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "afk-code",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Monitor and interact with Claude Code sessions from Slack/Discord/Telegram",
   "author": "Colin Harman",
   "repository": {

slack-manifest.json

@@ -56,6 +56,7 @@
         "chat:write",
         "chat:write.customize",
         "commands",
+        "files:write",
         "groups:history",
         "groups:write",
         "users:read"

src/cli/discord.ts

@@ -59,6 +59,7 @@ Step 3: Invite the Bot
    • Send Messages
    • Manage Channels
    • Read Message History
+   • Attach Files
 4. Copy the URL and open it to invite the bot to your server
 `);
 

src/cli/run.ts

@@ -72,6 +72,23 @@ export async function run(command: string[]): Promise<void> {
   const cwd = process.cwd();
   const projectDir = getClaudeProjectDir(cwd);
 
+  // Show loading spinner while starting
+  const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let spinnerIndex = 0;
+  let spinnerInterval: ReturnType<typeof setInterval> | null = setInterval(() => {
+    process.stdout.write(`\r${spinnerFrames[spinnerIndex]} Starting...`);
+    spinnerIndex = (spinnerIndex + 1) % spinnerFrames.length;
+  }, 80);
+
+  const stopSpinner = () => {
+    if (spinnerInterval) {
+      clearInterval(spinnerInterval);
+      spinnerInterval = null;
+      // Clear the spinner line
+      process.stdout.write('\r\x1b[K');
+    }
+  };
+
   // Use node-pty for full terminal features + remote input
   const cols = process.stdout.columns || 80;
   const rows = process.stdout.rows || 24;
@@ -99,6 +116,7 @@ export async function run(command: string[]): Promise<void> {
   }
 
   ptyProcess.onData((data: string) => {
+    stopSpinner();
     process.stdout.write(data);
   });
 

src/telegram/telegram-app.ts

@@ -1,7 +1,8 @@
-import { Bot, Context } from 'grammy';
+import { Bot, Context, InputFile } from 'grammy';
 import type { TelegramConfig } from './types.js';
 import { SessionManager, type SessionInfo } from '../slack/session-manager.js';
 import { chunkMessage, formatTodos } from '../slack/message-formatter.js';
+import { extractImagePaths } from '../utils/image-extractor.js';
 
 // Telegram has a 4096 character limit per message
 const MAX_MESSAGE_LENGTH = 4000;
@@ -144,6 +145,30 @@ export function createTelegramApp(config: TelegramConfig) {
         await sendChunkedMessage(content, `_User (terminal):_`, { disable_notification: true });
       } else {
         await sendChunkedMessage(content, `_Claude Code:_`);
+
+        // Extract and upload any images mentioned in the response
+        const session = sessionManager.getSession(sessionId);
+        const images = extractImagePaths(content, session?.cwd);
+        for (const image of images) {
+          try {
+            console.log(`[Telegram] Uploading image: ${image.resolvedPath}`);
+            const isGif = image.resolvedPath.toLowerCase().endsWith('.gif');
+            messageQueue.push(async () => {
+              if (isGif) {
+                await bot.api.sendAnimation(config.chatId, new InputFile(image.resolvedPath), {
+                  caption: `📎 ${image.originalPath}`,
+                });
+              } else {
+                await bot.api.sendPhoto(config.chatId, new InputFile(image.resolvedPath), {
+                  caption: `📎 ${image.originalPath}`,
+                });
+              }
+            });
+            processQueue();
+          } catch (err) {
+            console.error('[Telegram] Failed to upload image:', err);
+          }
+        }
       }
     },