opencode-avatar 0.3.0 → 0.3.2

package/README.md

@@ -2,7 +2,7 @@
 
 A dynamic desktop avatar plugin for OpenCode that displays animated character reactions based on your coding activities.
 
-<div align="center"><img src="avatar.png" alt="Avatar" width="200" /></div>
+<div align="center"><img src="https://github.com/user-attachments/assets/504043c9-954d-4cfd-93ff-0904d2d4eb95" alt="Avatar" width="300" /></div>
 
 ## Features
 
@@ -13,15 +13,10 @@ A dynamic desktop avatar plugin for OpenCode that displays animated character re
 - **Non-Intrusive**: Appears without stealing focus, stays on top
 - **Auto-Shutdown**: Automatically closes when OpenCode exits
 - **Toast Notifications**: Shows progress for avatar generation
+- **Customizable Prompts**: Optional prompt configuration for personalized avatar styles
 
 ## Installation
 
-### Option 1: From NPM (Recommended)
-
-```bash
-npm install -g opencode-avatar
-```
-
 Then add to your OpenCode config:
 
 ```json
@@ -31,15 +26,6 @@ Then add to your OpenCode config:
 }
 ```
 
-### Option 2: Local Development
-
-1. Clone this repository
-2. Run `npm install`
-3. Run `npm run build`
-4. Copy to your OpenCode plugins directory:
-   - Project: `.opencode/plugins/`
-   - Global: `~/.config/opencode/plugins/`
-
 ## Configuration
 
 ### API Key Configuration
@@ -54,6 +40,19 @@ Create a config file at `~/.config/opencode/opencode-avatar.json`:
 
 Get your FAL.ai API key from [fal.ai](https://fal.ai).
 
+### Custom Prompt Configuration (Optional)
+
+You can optionally add a `"prompt"` field to customize how avatars are generated. This text will be appended to all avatar generation prompts:
+
+```json
+{
+  "falKey": "your_fal_ai_api_key_here",
+  "prompt": "in a futuristic cyberpunk style with neon lights"
+}
+```
+
+The prompt will be added to the end of the AI generation request, allowing you to customize the avatar style, theme, or appearance consistently across all avatar variants.
+
 ### Avatar Images
 
 The plugin automatically downloads a default avatar (`avatar.png`) to `~/.config/opencode/avatar.png` if it doesn't exist. This serves as the source image for generating animated variants.
@@ -87,20 +86,6 @@ All avatars are stored in `~/.config/opencode/` for persistence across updates.
 | **Thinking** | User message | "Thinking hard" animation while processing |
 | **Tool Active** | Tool execution | Pose based on current tool (write, read, etc.) |
 
-### Tool Mappings
-
-The avatar automatically detects which tools you're using and shows appropriate reactions:
-
-| Tool | Avatar Pose |
-|------|-------------|
-| `write` | Writing with pencil |
-| `read` | Reading a book |
-| `edit` | Editing with scissors |
-| `glob` | Searching with magnifying glass |
-| `grep` | Detective searching |
-| `bash` | Hacker typing |
-| `webfetch` | Surfing the web |
-
 ### File Naming
 
 Avatar images are cached with predictable filenames:
@@ -254,4 +239,4 @@ MIT License - see LICENSE file for details.
 - Tool-based reactions
 - Caching system
 - Auto-shutdown
-- Focus protection
+- Focus protection

package/dist/electron.js

@@ -405,18 +405,18 @@ import * as fs from "fs";
 import * as os from "os";
 import { fileURLToPath } from "url";
 require_main().config();
-function getFalKey() {
+function getConfig() {
   try {
     const configPath = path.join(os.homedir(), ".config", "opencode", "opencode-avatar.json");
     const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
     if (!config.falKey) {
       console.warn("Warning: falKey not found in config file. Avatar generation will not work. Please set falKey in ~/.config/opencode/opencode-avatar.json");
-      return null;
+      return { falKey: null, prompt: null };
     }
-    return config.falKey;
+    return { falKey: config.falKey, prompt: config.prompt || null };
   } catch (error) {
     console.warn(`Warning: Failed to read config file: ${error.message}. Avatar generation will not work. Please ensure ~/.config/opencode/opencode-avatar.json exists and contains falKey.`);
-    return null;
+    return { falKey: null, prompt: null };
   }
 }
 var FAL_CDN_URL = "https://v3.fal.media";
@@ -627,8 +627,8 @@ async function downloadImage(url, outputPath) {
   fs.writeFileSync(outputPath, buffer);
 }
 async function generateAvatarForPrompt(prompt) {
-  const falKey = getFalKey();
-  if (!falKey) {
+  const config = getConfig();
+  if (!config.falKey) {
     console.warn("falKey is not set. Cannot generate avatar. Using default avatar.");
     return path.join(AVATAR_DIR, "avatar.png");
   }
@@ -647,9 +647,12 @@ async function generateAvatarForPrompt(prompt) {
         return;
       }
       const sourceAvatar = path.join(AVATAR_DIR, "avatar.png");
-      const uploadedUrl = await uploadFile(sourceAvatar, falKey);
-      const fullPrompt = `make a character variant: ${prompt}. Keep the background as a solid green screen color. Do not let the green screen color appear in reflections or on the subject.`;
-      const result = await generateAvatarImage(uploadedUrl, fullPrompt, falKey);
+      const uploadedUrl = await uploadFile(sourceAvatar, config.falKey);
+      let fullPrompt = `make a character variant: ${prompt}. Keep the background as a solid green screen color. Do not let the green screen color appear in reflections or on the subject.`;
+      if (config.prompt) {
+        fullPrompt += ` ${config.prompt}`;
+      }
+      const result = await generateAvatarImage(uploadedUrl, fullPrompt, config.falKey);
       const outputUrl = result.images?.[0]?.url || result.image?.url || result.url;
       if (!outputUrl) {
         throw new Error("No output image URL in response: " + JSON.stringify(result, null, 2));

package/dist/index.js

@@ -4,9 +4,11 @@ import { spawn } from "child_process";
 import * as path from "path";
 import * as http from "http";
 import * as fs from "fs";
+import * as os from "os";
 var __dirname = "/var/home/wizard/av";
 var AVATAR_DIR = __dirname;
 var DEFAULT_AVATAR = "avatar.png";
+var USER_AVATAR = path.join(os.homedir(), ".config", "opencode", "avatar.png");
 var THINKING_PROMPT = "thinking hard";
 var AVATAR_PORT = 47291;
 function getToolPrompt(toolName, toolDescription) {
@@ -17,10 +19,11 @@ function getToolPrompt(toolName, toolDescription) {
   return toolName;
 }
 var electronProcess = null;
-var currentAvatar = DEFAULT_AVATAR;
+var currentAvatar = getAvatarPath();
 var isThinking = false;
 var isToolActive = false;
 var isShuttingDown = false;
+var idleTriggered = false;
 var heartbeatInterval = null;
 function sendHeartbeat() {
   const req = http.request({
@@ -90,6 +93,9 @@ function promptToFilename(prompt, toolName) {
 }
 function getAvatarPath(prompt, toolName) {
   if (!prompt) {
+    if (fs.existsSync(USER_AVATAR)) {
+      return USER_AVATAR;
+    }
     return path.join(AVATAR_DIR, DEFAULT_AVATAR);
   }
   const filename = promptToFilename(prompt, toolName);
@@ -229,12 +235,15 @@ var AvatarPlugin = async ({ client }) => {
         res.on("end", () => {
           if (!showToasts) {
             isToolActive = false;
+            isThinking = false;
           }
           if (res.statusCode === 200) {
             if (showToasts) {
               showInfoToast(`Avatar ready: ${prompt}`);
             }
-            setAvatarViaHttp(prompt, toolName);
+            if (!idleTriggered || showToasts) {
+              setAvatarViaHttp(prompt, toolName);
+            }
             resolve();
           } else {
             if (showToasts) {
@@ -268,14 +277,18 @@ var AvatarPlugin = async ({ client }) => {
       const userMessage = output.parts.find((part) => part.type === "text" && part.messageID === input.messageID);
       if (userMessage?.text) {}
       if (userMessage?.text && !isThinking) {
+        idleTriggered = false;
         isThinking = true;
-        await requestAvatarGeneration(THINKING_PROMPT);
+        requestAvatarGeneration(THINKING_PROMPT, false).catch(() => {
+          isThinking = false;
+        });
       }
     },
     "tool.execute.before": async (input) => {
       const toolName = input.tool;
       const toolDescription = getToolDescription(toolName);
       const prompt = getToolPrompt(toolName, toolDescription);
+      idleTriggered = false;
       isToolActive = true;
       requestAvatarGeneration(prompt, false, toolName).catch((err) => {
         isToolActive = false;
@@ -283,6 +296,7 @@ var AvatarPlugin = async ({ client }) => {
     },
     event: async ({ event }) => {
       if (event.type === "session.idle" && (isThinking || isToolActive)) {
+        idleTriggered = true;
         isThinking = false;
         isToolActive = false;
         await setAvatarViaHttp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-avatar",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Dynamic desktop avatar plugin for OpenCode that reacts to your coding activities",
   "type": "module",
   "main": "./dist/index.js",