@banaxi/banana-code 1.1.0 → 1.2.0

package/README.md

@@ -41,14 +41,22 @@ Banana Code is a high-performance, terminal-based AI pair programmer. It combine
                                              #S#SSSSSS%%%?%%%%S
 ```
 
+## 🤔 Why Banana Code?
+While tools like Cursor provide great GUI experiences, Banana Code is built for developers who live in the terminal and want maximum flexibility. 
+- **No Vendor Lock-in**: Switch instantly between the best proprietary models (Gemini, Claude, OpenAI) and high-performance open-source models (Ollama Local, Ollama Cloud) mid-conversation.
+- **True Autonomy**: With Plan & Execute mode and Self-Healing Error Loops, Banana Code doesn't just suggest code; it tries, fails, reads the errors, and fixes its own mistakes automatically.
+- **Terminal Native**: It brings the power of full workspace awareness, web search, and surgical file patching directly to your CLI without forcing you to change your IDE.
+
 ## ✨ Key Features
 
-- **Multi-Provider Support**: Switch between **Google Gemini**, **Anthropic Claude**, **OpenAI**, and **Ollama (Local)** effortlessly.
-- **Interactive TUI**: A beautiful, minimal terminal interface with real-time feedback and progress indicators.
+- **Multi-Provider Support**: Switch between **Google Gemini**, **Anthropic Claude**, **OpenAI**, **Ollama Cloud**, and **Ollama (Local)** effortlessly.
+- **Plan & Agent Modes**: Use `/agent` for instant execution, or `/plan` to make the AI draft a step-by-step implementation plan for your approval before it touches any code.
+- **Self-Healing Loop**: If the AI runs a command (like running tests) and it fails, Banana Code automatically feeds the error trace back to the AI so it can fix its own code.
+- **Agent Skills**: Teach your AI specialized workflows. Drop a `SKILL.md` file in your config folder, and the AI will automatically activate it when relevant.
+- **Smart Context**: Use `@file/path.js` to instantly inject file contents into your prompt, or use `/settings` to auto-feed your entire workspace structure (respecting `.gitignore`).
+- **Web Research**: Deep integration with DuckDuckGo APIs and Scrapers to give the AI real-time access to the internet.
 - **Persistent Sessions**: All chats are saved to `~/.config/banana-code/chats/`. Resume any session with a single command.
-- **Robust Tool System**: Banana Code can execute shell commands, read/write files, fetch URLs, and search your workspace.
-- **Security First**: A dedicated permission model ensures no tool is executed without your explicit approval.
-- **Keyless Playground**: Integration with OpenAI Codex for seamless, keyless access to GPT-4o and beyond.
+- **Syntax Highlighting**: Beautiful, readable markdown output with syntax coloring directly in your terminal.
 
 ## 🚀 Installation
 
@@ -96,6 +104,28 @@ Banana Code can assist you by:
 - **`search_files`**: Performing regex searches across your project.
 - **`list_directory`**: Exploring folder structures.
 
+### 🧠 Agent Skills
+Banana Code supports custom Agent Skills. Skills are like "onboarding guides" that teach the AI how to do specific tasks, use certain APIs, or follow your company's coding standards. 
+
+When the AI detects a task that matches a skill's description, it automatically activates the skill and loads its specialized instructions.
+
+**How to create a Skill:**
+1. Create a folder in your config directory: `~/.config/banana-code/skills/my-react-skill/`
+2. Create a `SKILL.md` file inside that folder using this exact format:
+
+```markdown
+---
+name: my-react-skill
+description: Use this skill whenever you are asked to build or edit a React component.
+---
+
+# React Guidelines
+- Always use functional components.
+- Always use Tailwind CSS for styling.
+- Do not use default exports.
+```
+3. Type `/skills` in Banana Code to verify it loaded. The AI will now follow these rules automatically!
+
 ## 🔐 Privacy & Security
 
 Banana Code is built with transparency in mind:

package/package.json

@@ -1,7 +1,19 @@
 {
     "name": "@banaxi/banana-code",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "description": "🍌 BananaCode",
+    "keywords": [
+        "banana",
+        "ai",
+        "cli",
+        "agent",
+        "coding-assistant",
+        "terminal",
+        "gemini",
+        "claude",
+        "openai",
+        "ollama"
+    ],
     "type": "module",
     "license": "GPL-3.0-or-later",
     "bin": {

package/src/config.js

@@ -41,10 +41,10 @@ export async function setupProvider(provider, config = {}) {
             default: config.apiKey
         });
         config.model = await select({
-            message: 'Select a model:',
-            choices: OPENAI_MODELS
+            message: 'Select a Gemini model:',
+            choices: GEMINI_MODELS
         });
-        } else if (provider === 'ollama_cloud') {
+    } else if (provider === 'ollama_cloud') {
             config.apiKey = await input({
                 message: 'Enter your OLLAMA_API_KEY (from ollama.com):',
                 default: config.apiKey
@@ -65,7 +65,7 @@ export async function setupProvider(provider, config = {}) {
                 });
             }
             config.model = selectedModel;
-        } else if (provider === 'ollama') {
+        } else if (provider === 'claude') {
         config.apiKey = await input({
             message: 'Enter your ANTHROPIC_API_KEY:',
             default: config.apiKey

package/src/index.js

@@ -1,5 +1,6 @@
 import readline from 'readline';
 import chalk from 'chalk';
+import ora from 'ora';
 import { loadConfig, saveConfig, setupProvider } from './config.js';
 import { runStartup } from './startup.js';
 import { getSessionPermissions } from './permissions.js';
@@ -12,6 +13,7 @@ import { OllamaCloudProvider } from './providers/ollamaCloud.js';
 
 import { loadSession, saveSession, generateSessionId, getLatestSessionId, listSessions } from './sessions.js';
 import { printMarkdown } from './utils/markdown.js';
+import { estimateConversationTokens } from './utils/tokens.js';
 
 let config;
 let providerInstance;
@@ -62,7 +64,7 @@ async function handleSlashCommand(command) {
                 providerInstance = createProvider();
                 console.log(chalk.green(`Switched provider to ${newProv} (${config.model}).`));
             } else {
-                console.log(chalk.yellow(`Usage: /provider <gemini|claude|openai|ollama>`));
+                console.log(chalk.yellow(`Usage: /provider <gemini|claude|openai|ollama_cloud|ollama>`));
             }
             break;
         case '/model':
@@ -130,11 +132,86 @@ async function handleSlashCommand(command) {
             providerInstance = createProvider(); // fresh instance = clear history
             console.log(chalk.green('Chat history cleared.'));
             break;
+        case '/clean':
+            if (!config.betaTools || !config.betaTools.includes('clean_command')) {
+                console.log(chalk.yellow("The /clean command is a beta feature. You need to enable it in the /beta menu first."));
+                break;
+            }
+            const msgCount = providerInstance.messages ? providerInstance.messages.length : 0;
+            if (msgCount <= 2) {
+                console.log(chalk.yellow("Not enough history to summarize."));
+                break;
+            }
+            
+            console.log(chalk.cyan("Summarizing context to save tokens..."));
+            const summarySpinner = ora({ text: 'Compressing history...', color: 'yellow', stream: process.stdout }).start();
+            
+            try {
+                // Temporarily disable terminal formatting for the summary request
+                const originalUseMarked = config.useMarkedTerminal;
+                config.useMarkedTerminal = false;
+                
+                // Create a temporary prompt asking for a summary
+                const summaryPrompt = "SYSTEM INSTRUCTION: Please provide a highly concise summary of our entire conversation so far. Focus ONLY on the overall goal, the current state of the project, any important decisions made, and what we were about to do next. Do not include pleasantries. This summary will be used as your memory going forward.";
+                
+                // Ask the AI to summarize
+                const summary = await providerInstance.sendMessage(summaryPrompt);
+                
+                // Restore settings
+                config.useMarkedTerminal = originalUseMarked;
+                summarySpinner.stop();
+                
+                // Re-initialize the provider to wipe old history
+                providerInstance = createProvider();
+                
+                // Inject the summary as the first message after the system prompt
+                const summaryMemory = `[PREVIOUS CONVERSATION SUMMARY]\n${summary}`;
+                
+                if (config.provider === 'gemini') {
+                    providerInstance.messages.push({ role: 'user', parts: [{ text: summaryMemory }] });
+                    providerInstance.messages.push({ role: 'model', parts: [{ text: "I have stored the summary of our previous conversation in my memory." }] });
+                } else if (config.provider === 'claude') {
+                    providerInstance.messages.push({ role: 'user', content: summaryMemory });
+                    providerInstance.messages.push({ role: 'assistant', content: "I have stored the summary of our previous conversation in my memory." });
+                } else {
+                    providerInstance.messages.push({ role: 'user', content: summaryMemory });
+                    providerInstance.messages.push({ role: 'assistant', content: "I have stored the summary of our previous conversation in my memory." });
+                }
+                
+                console.log(chalk.green(`\nContext successfully compressed!`));
+                if (config.debug) {
+                    console.log(chalk.gray(`\n[Saved Summary]:\n${summary}\n`));
+                }
+                
+                await saveSession(currentSessionId, {
+                    provider: config.provider,
+                    model: config.model || providerInstance.modelName,
+                    messages: providerInstance.messages
+                });
+                
+            } catch (err) {
+                summarySpinner.stop();
+                console.log(chalk.red(`Failed to compress context: ${err.message}`));
+            }
+            break;
         case '/context':
             let length = 0;
-            if (providerInstance.messages) length = providerInstance.messages.length;
-            else if (providerInstance.chat) length = (await providerInstance.chat.getHistory()).length;
-            console.log(chalk.cyan(`Current context contains approximately ${length} messages.`));
+            let messagesForEstimation = [];
+            
+            if (providerInstance.messages) {
+                length = providerInstance.messages.length;
+                messagesForEstimation = providerInstance.messages;
+            } else if (providerInstance.chat) {
+                messagesForEstimation = await providerInstance.chat.getHistory();
+                length = messagesForEstimation.length;
+            }
+            
+            const { estimateConversationTokens } = await import('./utils/tokens.js');
+            const estimatedTokens = estimateConversationTokens(messagesForEstimation);
+            
+            console.log(chalk.cyan(`Current context:`));
+            console.log(chalk.cyan(`- Messages: ${length}`));
+            console.log(chalk.cyan(`- Estimated Tokens: ~${estimatedTokens.toLocaleString()}`));
             break;
         case '/permissions':
             const perms = getSessionPermissions();
@@ -149,18 +226,27 @@ async function handleSlashCommand(command) {
             const { TOOLS } = await import('./tools/registry.js');
             const betaTools = TOOLS.filter(t => t.beta);
 
-            if (betaTools.length === 0) {
-                console.log(chalk.yellow("No beta tools available."));
+            let choices = betaTools.map(t => ({
+                name: t.label || t.name,
+                value: t.name,
+                checked: (config.betaTools || []).includes(t.name)
+            }));
+            
+            // Add beta commands that aren't tools
+            choices.push({
+                name: '/clean command (Context Compression)',
+                value: 'clean_command',
+                checked: (config.betaTools || []).includes('clean_command')
+            });
+
+            if (choices.length === 0) {
+                console.log(chalk.yellow("No beta features available."));
                 break;
             }
 
             const enabledBetaTools = await checkbox({
-                message: 'Select beta tools to activate (Space to toggle, Enter to confirm):',
-                choices: betaTools.map(t => ({
-                    name: t.label || t.name,
-                    value: t.name,
-                    checked: (config.betaTools || []).includes(t.name)
-                }))
+                message: 'Select beta features to activate (Space to toggle, Enter to confirm):',
+                choices: choices
             });
 
             if (enabledBetaTools.includes('duck_duck_go_scrape') && !(config.betaTools || []).includes('duck_duck_go_scrape')) {
@@ -182,7 +268,13 @@ async function handleSlashCommand(command) {
 
             config.betaTools = enabledBetaTools;
             await saveConfig(config);
-            providerInstance = createProvider(); // Re-init to update tools
+            if (providerInstance) {
+                const savedMessages = providerInstance.messages;
+                providerInstance = createProvider(); // Re-init to update tools
+                providerInstance.messages = savedMessages;
+            } else {
+                providerInstance = createProvider();
+            }
             console.log(chalk.green(`Beta tools updated: ${enabledBetaTools.join(', ') || 'none'}`));
             break;
         case '/settings':
@@ -199,22 +291,80 @@ async function handleSlashCommand(command) {
                         name: 'Use syntax highlighting for AI output (requires waiting for full response)',
                         value: 'useMarkedTerminal',
                         checked: config.useMarkedTerminal || false
+                    },
+                    {
+                        name: 'Always show current token count in status bar',
+                        value: 'showTokenCount',
+                        checked: config.showTokenCount || false
                     }
                 ]
             });
             
             config.autoFeedWorkspace = enabledSettings.includes('autoFeedWorkspace');
             config.useMarkedTerminal = enabledSettings.includes('useMarkedTerminal');
+            config.showTokenCount = enabledSettings.includes('showTokenCount');
             await saveConfig(config);
-            providerInstance = createProvider(); // Re-init to update tools/config
+            if (providerInstance) {
+                const savedMessages = providerInstance.messages;
+                providerInstance = createProvider(); // Re-init to update tools/config
+                providerInstance.messages = savedMessages;
+            } else {
+                providerInstance = createProvider();
+            }
             console.log(chalk.green(`Settings updated.`));
             break;
         case '/debug':
             config.debug = !config.debug;
             await saveConfig(config);
-            providerInstance = createProvider(); // Re-init to pass debug flag
+            if (providerInstance) {
+                const savedMessages = providerInstance.messages;
+                providerInstance = createProvider(); // Re-init to pass debug flag
+                providerInstance.messages = savedMessages;
+            } else {
+                providerInstance = createProvider();
+            }
             console.log(chalk.magenta(`Debug mode ${config.debug ? 'enabled' : 'disabled'}.`));
             break;
+        case '/skills':
+            const { getAvailableSkills } = await import('./utils/skills.js');
+            const skills = getAvailableSkills();
+            if (skills.length === 0) {
+                console.log(chalk.yellow("No skills found."));
+                const os = await import('os');
+                const path = await import('path');
+                const skillsDir = path.join(os.homedir(), '.config', 'banana-code', 'skills');
+                console.log(chalk.gray(`Create skill directories with a SKILL.md file in ${skillsDir}`));
+            } else {
+                console.log(chalk.cyan.bold("\nLoaded Skills:"));
+                skills.forEach(skill => {
+                    console.log(chalk.green(`- ${skill.id}`) + `: ${skill.description}`);
+                });
+            }
+            break;
+        case '/plan':
+            config.planMode = true;
+            await saveConfig(config);
+            if (providerInstance) {
+                const savedMessages = providerInstance.messages;
+                providerInstance = createProvider();
+                providerInstance.messages = savedMessages;
+            } else {
+                providerInstance = createProvider();
+            }
+            console.log(chalk.magenta(`Plan mode enabled. For significant changes, the AI will now propose an implementation plan before writing code.`));
+            break;
+        case '/agent':
+            config.planMode = false;
+            await saveConfig(config);
+            if (providerInstance) {
+                const savedMessages = providerInstance.messages;
+                providerInstance = createProvider();
+                providerInstance.messages = savedMessages;
+            } else {
+                providerInstance = createProvider();
+            }
+            console.log(chalk.green(`Agent mode enabled. The AI will make changes directly.`));
+            break;
         case '/chats':
             const sessions = await listSessions();
             if (sessions.length === 0) {
@@ -231,14 +381,18 @@ async function handleSlashCommand(command) {
         case '/help':
             console.log(chalk.yellow(`
 Available commands:
-  /provider <name> - Switch AI provider (gemini, claude, openai, ollama)
+  /provider <name> - Switch AI provider (gemini, claude, openai, ollama_cloud, ollama)
   /model [name]    - Switch model within current provider (opens menu if name omitted)
   /chats           - List persistent chat sessions
   /clear           - Clear chat history
+  /clean           - Compress chat history into a summary to save tokens
   /context         - Show current context window size
   /permissions     - List session-approved permissions
   /beta            - Manage beta features and tools
   /settings        - Manage app settings (workspace auto-feed, etc)
+  /skills          - List loaded agent skills
+  /plan            - Enable Plan Mode (AI proposes a plan for big changes)
+  /agent           - Enable Agent Mode (default, AI edits directly)
   /debug           - Toggle debug mode (show tool results)
   /help            - Show all commands
   /exit            - Quit Banana Code
@@ -278,7 +432,7 @@ function drawPromptBox(inputText, cursorPos) {
     const placeholder = 'Type your message or @path/to/file';
     const prefix = ' > ';
 
-    const visibleText = (inputText.length === 0) ? (prefix + chalk.gray(placeholder)) : (prefix + inputText);
+    const visibleText = (inputText.length === 0) ? (prefix + chalk.gray(placeholder)) : (prefix + chalk.white(inputText));
     const totalChars = (prefix.length + Math.max(inputText.length, placeholder.length));
     const rows = Math.ceil(totalChars / width) || 1;
 
@@ -298,8 +452,26 @@ function drawPromptBox(inputText, cursorPos) {
     // Redraw status bar and separator (they are always below the prompt)
     const modelDisplay = providerInstance ? providerInstance.modelName : (config.model || 'unknown');
     const providerDisplay = config.provider.toUpperCase();
-    const leftText = ` Provider: ${chalk.cyan(providerDisplay)} / Model: ${chalk.yellow(modelDisplay)}`;
-    const rightText = '? for shortcuts ';
+    const modeDisplay = config.planMode ? chalk.magenta('PLAN MODE') : chalk.green('AGENT MODE');
+    
+    let tokenDisplay = '';
+    if (config.showTokenCount && providerInstance) {
+        let msgs = providerInstance.messages || [];
+        // Support for Ollama chat history format if different
+        if (!providerInstance.messages && typeof providerInstance.chat?.getHistory === 'function') {
+            msgs = providerInstance.chat.getHistory(); // Note: this is async normally, but we use an approximation here or just skip it if it's strictly async. For now, assume providerInstance.messages is the standard.
+        }
+        const tokens = estimateConversationTokens(msgs);
+        let color = chalk.green;
+        if (tokens >= 128000) color = chalk.red;
+        else if (tokens >= 86000) color = chalk.hex('#FFA500'); // Orange
+        else if (tokens >= 64000) color = chalk.yellow;
+        
+        tokenDisplay = ` / Tokens: ${color(tokens.toLocaleString())}`;
+    }
+    
+    const leftText = ` Provider: ${chalk.cyan(providerDisplay)} / Model: ${chalk.yellow(modelDisplay)} / ${modeDisplay}${tokenDisplay}`;
+    const rightText = '/help for shortcuts ';
     const leftStripped = leftText.replace(/\x1b\[[0-9;]*m/g, '');
     const midPad = Math.max(0, width - leftStripped.length - rightText.length);
     const statusLine = chalk.gray(leftText + ' '.repeat(midPad) + rightText);
@@ -325,7 +497,7 @@ function drawPromptBoxInitial(inputText) {
     const placeholder = 'Type your message or @path/to/file';
     const prefix = ' > ';
 
-    const visibleText = (inputText.length === 0) ? (prefix + chalk.gray(placeholder)) : (prefix + inputText);
+    const visibleText = (inputText.length === 0) ? (prefix + chalk.gray(placeholder)) : (prefix + chalk.white(inputText));
     const totalChars = (prefix.length + Math.max(inputText.length, placeholder.length));
     const rows = Math.ceil(totalChars / width) || 1;
 
@@ -338,11 +510,29 @@ function drawPromptBoxInitial(inputText) {
         process.stdout.write(userBg(padLine(lineText, width)) + '\n');
     }
 
-    // Status bar: Current Provider / Model + right-aligned "? for shortcuts"
+    // Status bar: Current Provider / Model + right-aligned "/help for shortcuts"
     const modelDisplay = providerInstance ? providerInstance.modelName : (config.model || 'unknown');
     const providerDisplay = config.provider.toUpperCase();
-    const leftText = ` Provider: ${chalk.cyan(providerDisplay)} / Model: ${chalk.yellow(modelDisplay)}`;
-    const rightText = '? for shortcuts ';
+    const modeDisplay = config.planMode ? chalk.magenta('PLAN MODE') : chalk.green('AGENT MODE');
+    
+    let tokenDisplay = '';
+    if (config.showTokenCount && providerInstance) {
+        let msgs = providerInstance.messages || [];
+        // Support for Ollama chat history format if different
+        if (!providerInstance.messages && typeof providerInstance.chat?.getHistory === 'function') {
+            msgs = providerInstance.chat.getHistory(); // Note: this is async normally, but we use an approximation here or just skip it if it's strictly async. For now, assume providerInstance.messages is the standard.
+        }
+        const tokens = estimateConversationTokens(msgs);
+        let color = chalk.green;
+        if (tokens >= 128000) color = chalk.red;
+        else if (tokens >= 86000) color = chalk.hex('#FFA500'); // Orange
+        else if (tokens >= 64000) color = chalk.yellow;
+        
+        tokenDisplay = ` / Tokens: ${color(tokens.toLocaleString())}`;
+    }
+    
+    const leftText = ` Provider: ${chalk.cyan(providerDisplay)} / Model: ${chalk.yellow(modelDisplay)} / ${modeDisplay}${tokenDisplay}`;
+    const rightText = '/help for shortcuts ';
 
     const leftStripped = leftText.replace(/\x1b\[[0-9;]*m/g, '');
     const midPad = Math.max(0, width - leftStripped.length - rightText.length);

package/src/prompt.js

@@ -1,5 +1,6 @@
 import os from 'os';
 import { getAvailableTools } from './tools/registry.js';
+import { getAvailableSkills } from './utils/skills.js';
 
 export function getSystemPrompt(config = {}) {
     const platform = os.platform();
@@ -16,6 +17,7 @@ export function getSystemPrompt(config = {}) {
     const availableToolsList = getAvailableTools(config);
     const availableToolsNames = availableToolsList.map(t => t.name).join(', ');
     const hasPatchTool = availableToolsList.some(t => t.name === 'patch_file');
+    const skills = getAvailableSkills();
 
     let prompt = `You are Banana Code, a terminal-based AI coding assistant running on ${osDescription}. You help users write, debug, and understand code. You have access to tools: ${availableToolsNames}. 
 
@@ -27,6 +29,26 @@ SAFETY RULES:
 
 Always use tools when they would help. Be concise but thorough. `;
 
+    if (skills && skills.length > 0) {
+        prompt += `\n\n# Available Agent Skills\n\nYou have access to the following specialized skills. To activate a skill and receive its detailed instructions, call the \`activate_skill\` tool with the skill's name.\n\n<available_skills>\n`;
+        for (const skill of skills) {
+            prompt += `  <skill>\n    <name>${skill.id}</name>\n    <description>${skill.description}</description>\n  </skill>\n`;
+        }
+        prompt += `</available_skills>\n\nOnce a skill is activated, its instructions and resources are returned wrapped in <activated_skill> tags. You MUST treat the content within <instructions> as expert procedural guidance for the duration of the task.\n`;
+    }
+
+    if (config.planMode) {
+        prompt += `
+[PLAN MODE ENABLED]
+The user is operating in "Plan Mode".
+- For very small, trivial changes (like fixing a typo or a one-line bug), you may execute the change directly using your tools.
+- For ANY change that has a significant impact, modifies multiple areas, or adds a new feature, you MUST NOT write or patch code immediately.
+- Instead, you MUST output a detailed "Implementation Plan" outlining the files you will change and the specific steps you will take.
+- Stop and ask the user: "Does this plan look good, or would you like to make any changes?"
+- ONLY proceed to use the 'write_file' or 'patch_file' tools AFTER the user has explicitly approved the plan.
+`;
+    }
+
     if (hasPatchTool) {
         prompt += `
 When editing existing files, PREFER using the 'patch_file' tool for surgical, targeted changes instead of 'write_file', especially for large files. This prevents accidental truncation and is much more efficient. Only use 'write_file' when creating new files or when making very extensive changes to a small file.`;

package/src/tools/activateSkill.js

@@ -0,0 +1,22 @@
+import { getAvailableSkills } from '../utils/skills.js';
+
+export async function activateSkill({ skillName }) {
+    const skills = getAvailableSkills();
+    // Match by ID or Name
+    const skill = skills.find(s => s.id === skillName || s.name === skillName);
+    
+    if (!skill) {
+        return `Error: Skill '${skillName}' not found. Available skills: ${skills.map(s => s.name).join(', ')}`;
+    }
+    
+    // The format expected by the AI agent
+    let output = `<activated_skill>\n`;
+    output += `<instructions>\n${skill.instructions}\n</instructions>\n`;
+    output += `<available_resources>\n`;
+    output += `- location: ${skill.path}\n`;
+    output += `  (Use list_directory and read_file to access bundled scripts, references, or assets)\n`;
+    output += `</available_resources>\n`;
+    output += `</activated_skill>`;
+    
+    return output;
+}

package/src/tools/registry.js

@@ -7,6 +7,7 @@ import { listDirectory } from './listDirectory.js';
 import { duckDuckGo } from './duckDuckGo.js';
 import { duckDuckGoScrape } from './duckDuckGoScrape.js';
 import { patchFile } from './patchFile.js';
+import { activateSkill } from './activateSkill.js';
 
 export const TOOLS = [
     {
@@ -133,6 +134,17 @@ export const TOOLS = [
             },
             required: ['filepath', 'edits']
         }
+    },
+    {
+        name: 'activate_skill',
+        description: 'Activates a specialized agent skill by name. Returns the skill\'s instructions wrapped in <activated_skill> tags. These provide specialized guidance for the current task.',
+        parameters: {
+            type: 'object',
+            properties: {
+                skillName: { type: 'string', description: 'The name or ID of the skill to activate.' }
+            },
+            required: ['skillName']
+        }
     }
 ];
 
@@ -156,6 +168,7 @@ export async function executeTool(name, args) {
         case 'duck_duck_go': return await duckDuckGo(args);
         case 'duck_duck_go_scrape': return await duckDuckGoScrape(args);
         case 'patch_file': return await patchFile(args);
+        case 'activate_skill': return await activateSkill(args);
         default: return `Unknown tool: ${name}`;
     }
 }

package/src/utils/skills.js

@@ -0,0 +1,61 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const SKILLS_DIR = path.join(os.homedir(), '.config', 'banana-code', 'skills');
+
+/**
+ * Scans the skills directory and parses SKILL.md files.
+ * @returns {Array} List of discovered skills.
+ */
+export function getAvailableSkills() {
+    try {
+        if (!fs.existsSync(SKILLS_DIR)) {
+            fs.mkdirSync(SKILLS_DIR, { recursive: true });
+        }
+    } catch (e) {
+        return [];
+    }
+
+    let skills = [];
+    try {
+        const entries = fs.readdirSync(SKILLS_DIR, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const skillPath = path.join(SKILLS_DIR, entry.name);
+                const mdPath = path.join(skillPath, 'SKILL.md');
+                
+                if (fs.existsSync(mdPath)) {
+                    try {
+                        const content = fs.readFileSync(mdPath, 'utf8');
+                        // Match YAML frontmatter between --- and ---
+                        const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+                        
+                        if (match) {
+                            const frontmatter = match[1];
+                            const body = content.slice(match[0].length).trim();
+                            
+                            // Simple YAML parsing via regex
+                            const nameMatch = frontmatter.match(/name:\s*['"]?([^'"\n]+)['"]?/);
+                            const descMatch = frontmatter.match(/description:\s*['"]?([^'"\n]+)['"]?/);
+                            
+                            if (nameMatch && descMatch) {
+                                skills.push({
+                                    id: entry.name,
+                                    name: nameMatch[1].trim(),
+                                    description: descMatch[1].trim(),
+                                    instructions: body,
+                                    path: skillPath
+                                });
+                            }
+                        }
+                    } catch (err) {
+                        // Skip corrupted or unreadable skills
+                    }
+                }
+            }
+        }
+    } catch (e) {}
+    
+    return skills;
+}

package/src/utils/tokens.js

@@ -0,0 +1,44 @@
+/**
+ * Estimates the number of tokens in a given string.
+ * This is a rough approximation (1 token ≈ 4 characters or ~0.75 words) 
+ * used to provide a quick estimate without needing heavy, provider-specific tokenizer libraries.
+ * 
+ * @param {string} text - The input text to estimate tokens for.
+ * @returns {number} The estimated token count.
+ */
+export function estimateTokens(text) {
+    if (!text || typeof text !== 'string') return 0;
+    
+    // A common heuristic: 1 token is roughly 4 English characters.
+    // For code, it can be denser, but this provides a reasonable ballpark.
+    return Math.ceil(text.length / 4);
+}
+
+/**
+ * Calculates the estimated token count for the entire conversation history.
+ * 
+ * @param {Array} messages - The array of message objects.
+ * @returns {number} The estimated total tokens.
+ */
+export function estimateConversationTokens(messages) {
+    if (!Array.isArray(messages)) return 0;
+    
+    let totalString = '';
+    
+    // Stringify the entire message array to get a representation of its "weight"
+    // This includes system prompts, tool calls, and results.
+    try {
+        totalString = JSON.stringify(messages);
+    } catch (e) {
+        // Fallback if there are circular references (unlikely in simple message arrays)
+        messages.forEach(msg => {
+            if (typeof msg === 'string') totalString += msg;
+            else if (msg && typeof msg === 'object') {
+                if (msg.content) totalString += typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+                if (msg.parts) totalString += JSON.stringify(msg.parts);
+            }
+        });
+    }
+
+    return estimateTokens(totalString);
+}