feat: 20 new features — themes, plugins, TF-IDF search, vision, history + more

Features added:
1. Persistent input history (~/.localcode/history.json, 200 entries)
2. Spinner animation — braille spinner during streaming/tool calls
3. Word wrapping — all message text wraps at terminal width
4. Theme system — dark/nord/monokai/light (/theme command)
5. Template system — /template add/use/list/delete (~/.localcode/templates.json)
6. Alias system — /alias name command (~/.localcode/aliases.json)
7. /explain — stream explanation of a file or last code snippet
8. /test — auto-detect jest/vitest/pytest/cargo/go test and run it
9. /share — export conversation as self-contained HTML page
10. Session history browser — /history [n], archives in ~/.localcode/sessions/
11. /git panel — status/log/stash/branch/passthrough
12. /watch — fs.watch file, re-run last message on change (/watch stop)
13. Auto-context on startup — inject git log+status if no .nyx.md found
14. Multi-file diff summary — shows +/- counts after agent modifies files
15. Collapsible tool output — truncates long output with [+N chars] indicator
16. Syntax highlighting — keywords/strings/numbers/comments per language
17. Plugin system — load ~/.localcode/plugins/*.js at startup (/plugins)
18. /image — vision input (base64), works with Claude/OpenAI/Ollama llava
19. Streaming token counter — live +N▌ in header during generation
20. TF-IDF semantic search — /index builds index, /search uses it

New files: src/plugins/loader.ts, src/search/tfidf.ts

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: thegreatalxx

src/core/types.ts

@@ -17,6 +17,7 @@ export interface ProviderConfig {
 export interface Message {
   role: 'user' | 'assistant' | 'system';
   content: string;
+  images?: Array<{ base64: string; mimeType: string }>;
 }
 
 export interface ToolCall {
@@ -51,6 +52,28 @@ export interface Persona {
   prompt: string;
 }
 
+// ── Theme system ─────────────────────────────────────────────────────────────
+
+export type ThemeName = 'dark' | 'nord' | 'monokai' | 'light';
+
+export interface Theme {
+  name: ThemeName;
+  primary: string;   // user prompt color
+  accent: string;    // assistant icon color
+  tool: string;      // tool message color
+  system: string;    // system message color
+  error: string;     // error color
+  border: string;    // input box border color
+  header: string;    // header art color
+}
+
+export const THEMES: Record<ThemeName, Theme> = {
+  dark:    { name: 'dark',    primary: 'yellowBright', accent: 'white',         tool: 'cyan',         system: 'gray', error: 'red', border: 'yellowBright', header: 'white' },
+  nord:    { name: 'nord',    primary: 'blueBright',   accent: 'cyanBright',    tool: 'cyan',         system: 'gray', error: 'red', border: 'blueBright',   header: 'cyanBright' },
+  monokai: { name: 'monokai', primary: 'greenBright',  accent: 'magentaBright', tool: 'yellowBright', system: 'gray', error: 'red', border: 'greenBright',  header: 'magentaBright' },
+  light:   { name: 'light',   primary: 'blue',         accent: 'black',         tool: 'cyan',         system: 'gray', error: 'red', border: 'blue',         header: 'blue' },
+};
+
 export interface SessionState {
   provider: Provider;
   model: string;
@@ -67,6 +90,7 @@ export interface SessionState {
   maxSteps: number;               // max agent tool-call iterations per response
   sessionCost: number;            // estimated USD cost this session
   lastAssistantMessage: string;   // for /retry and /copy
+  theme: ThemeName;               // UI color theme
 }
 
 export const DEFAULT_SYSTEM_PROMPT = `You are Nyx, an AI coding assistant built into LocalCode — a terminal tool made by TheAlxLabs.
@@ -270,6 +294,15 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     usage: '/steps 40',
     category: 'session',
   },
+  {
+    name: 'theme',
+    trigger: '/theme',
+    icon: '◑',
+    description: 'Switch color theme',
+    detail: 'List available themes or switch to one: dark, nord, monokai, light.',
+    usage: '/theme  |  /theme nord  |  /theme monokai',
+    category: 'session',
+  },
   // ── System & Personas ─────────────────────────────────────────────────────
   {
     name: 'sys',
@@ -333,6 +366,24 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     usage: '/open src/app.ts',
     category: 'context',
   },
+  {
+    name: 'template',
+    trigger: '/template',
+    icon: '⊞',
+    description: 'Manage prompt templates',
+    detail: 'List, add, use, or delete prompt templates. Usage: /template list | /template add <name> <prompt> | /template use <name> | /template delete <name>',
+    usage: '/template  |  /template add mytemplate Fix all TypeScript errors  |  /template use mytemplate',
+    category: 'context',
+  },
+  {
+    name: 'alias',
+    trigger: '/alias',
+    icon: '⇒',
+    description: 'Manage command aliases',
+    detail: 'Create shortcuts for commands. Usage: /alias | /alias <name> <command> | /alias delete <name>',
+    usage: '/alias  |  /alias review /review  |  /alias delete review',
+    category: 'session',
+  },
   {
     name: 'models',
     trigger: '/models',
@@ -387,6 +438,33 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     usage: '/commit',
     category: 'git',
   },
+  {
+    name: 'git',
+    trigger: '/git',
+    icon: '⎇',
+    description: 'Run git commands and show results',
+    detail: 'Quick git panel: status, log, stash, branch, or any git command. Usage: /git | /git log | /git stash | /git branch',
+    usage: '/git  |  /git log  |  /git stash  |  /git branch  |  /git diff HEAD',
+    category: 'git',
+  },
+  {
+    name: 'history',
+    trigger: '/history',
+    icon: '◷',
+    description: 'Browse and restore session history',
+    detail: 'List recent sessions or restore one by index.',
+    usage: '/history  |  /history 3',
+    category: 'session',
+  },
+  {
+    name: 'share',
+    trigger: '/share',
+    icon: '↗',
+    description: 'Export conversation as self-contained HTML',
+    detail: 'Generates a beautiful HTML file of the conversation with syntax highlighting.',
+    usage: '/share',
+    category: 'session',
+  },
   // ── Tools ─────────────────────────────────────────────────────────────────
   {
     name: 'init',
@@ -432,6 +510,60 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     usage: '/mcp list  |  /mcp add <n> stdio <cmd>  |  /mcp tools',
     category: 'tools',
   },
+  {
+    name: 'watch',
+    trigger: '/watch',
+    icon: '◉',
+    description: 'Watch a file for changes and re-run last message',
+    detail: 'Automatically re-sends your last message when a file changes. Usage: /watch <file> | /watch stop',
+    usage: '/watch src/app.ts  |  /watch stop  |  /watch',
+    category: 'tools',
+  },
+  {
+    name: 'explain',
+    trigger: '/explain',
+    icon: '◈',
+    description: 'Explain code — a file or the last snippet',
+    detail: 'Pass a file path to explain that file, or use with no args to explain the last code snippet.',
+    usage: '/explain  |  /explain src/app.ts',
+    category: 'tools',
+  },
+  {
+    name: 'test',
+    trigger: '/test',
+    icon: '✚',
+    description: 'Run tests using the detected test runner',
+    detail: 'Detects jest/vitest/pytest/cargo/go and runs tests. Offers to fix failures.',
+    usage: '/test',
+    category: 'tools',
+  },
+  {
+    name: 'image',
+    trigger: '/image',
+    icon: '⊞',
+    description: 'Load an image file for vision analysis',
+    detail: 'Read an image file and add it to the conversation for vision-capable models.',
+    usage: '/image screenshot.png',
+    category: 'context',
+  },
+  {
+    name: 'index',
+    trigger: '/index',
+    icon: '⌖',
+    description: 'Build TF-IDF search index for working directory',
+    detail: 'Indexes all text files for semantic search. Use /search after indexing for better results.',
+    usage: '/index',
+    category: 'tools',
+  },
+  {
+    name: 'plugins',
+    trigger: '/plugins',
+    icon: '⬡',
+    description: 'List loaded plugins',
+    detail: 'Shows all plugins loaded from ~/.localcode/plugins/',
+    usage: '/plugins',
+    category: 'tools',
+  },
   // ── Providers ─────────────────────────────────────────────────────────────
   {
     name: 'provider',
@@ -483,8 +615,8 @@ export const SLASH_COMMANDS: SlashCommand[] = [
     name: 'search',
     trigger: '/search',
     icon: '⌖',
-    description: 'Search file contents (grep)',
-    detail: 'Directly search for a pattern across all files in the working directory.',
+    description: 'Search file contents (grep or TF-IDF if indexed)',
+    detail: 'Search for a pattern. If /index has been run, uses TF-IDF scoring for semantic results.',
     usage: '/search TODO  |  /search "function render"',
     category: 'tools',
   },

src/plugins/loader.ts

@@ -0,0 +1,60 @@
+// src/plugins/loader.ts
+// Dynamic plugin loader for LocalCode
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
+export interface PluginContext {
+  workingDir: string;
+  sysMsg: (text: string, isError?: boolean) => void;
+  addDisplay: (msg: { role: string; content: string; isError?: boolean }) => string;
+}
+
+export interface LocalCodePlugin {
+  name: string;
+  trigger: string;       // e.g. '/myplugin'
+  description: string;
+  execute: (args: string, context: PluginContext) => Promise<void>;
+}
+
+const PLUGINS_DIR = path.join(os.homedir(), '.localcode', 'plugins');
+
+export async function loadPlugins(): Promise<LocalCodePlugin[]> {
+  const plugins: LocalCodePlugin[] = [];
+
+  try {
+    if (!fs.existsSync(PLUGINS_DIR)) {
+      fs.mkdirSync(PLUGINS_DIR, { recursive: true });
+      return plugins;
+    }
+
+    const files = fs.readdirSync(PLUGINS_DIR).filter((f) => f.endsWith('.js'));
+
+    for (const file of files) {
+      const filePath = path.join(PLUGINS_DIR, file);
+      try {
+        // Dynamic import using file URL for ESM compatibility
+        const fileUrl = new URL(`file://${filePath}`);
+        const mod = await import(fileUrl.href) as { default?: LocalCodePlugin };
+        const plugin = mod.default;
+
+        if (
+          plugin &&
+          typeof plugin.name === 'string' &&
+          typeof plugin.trigger === 'string' &&
+          typeof plugin.description === 'string' &&
+          typeof plugin.execute === 'function'
+        ) {
+          plugins.push(plugin);
+        }
+      } catch {
+        // Skip invalid plugins silently
+      }
+    }
+  } catch {
+    // If we can't read plugins dir, just return empty
+  }
+
+  return plugins;
+}

src/providers/client.ts

@@ -161,9 +161,16 @@ async function runOllamaAgent(
   systemPrompt?: string,
   signal?: AbortSignal,
 ): Promise<void> {
-  const history: Array<{ role: string; content: string }> = [];
+  type OllamaMsg = { role: string; content: string; images?: string[] };
+  const history: OllamaMsg[] = [];
   if (systemPrompt) history.push({ role: 'system', content: systemPrompt });
-  for (const m of messages) history.push({ role: m.role, content: m.content });
+  for (const m of messages) {
+    const entry: OllamaMsg = { role: m.role, content: m.content };
+    if (m.images && m.images.length > 0) {
+      entry.images = m.images.map((img) => img.base64);
+    }
+    history.push(entry);
+  }
 
   const tools = agentCfg.tools.map((t) => ({
     type: 'function',
@@ -257,10 +264,21 @@ async function runClaudeAgent(
   }));
 
   type AnthropicMsg = { role: 'user' | 'assistant'; content: string | unknown[] };
-  const history: AnthropicMsg[] = messages.map((m) => ({
-    role: m.role === 'assistant' ? 'assistant' : 'user',
-    content: m.content,
-  }));
+  const history: AnthropicMsg[] = messages.map((m) => {
+    if (m.images && m.images.length > 0) {
+      // Build content array with image blocks + text
+      const contentArr: unknown[] = m.images.map((img) => ({
+        type: 'image',
+        source: { type: 'base64', media_type: img.mimeType, data: img.base64 },
+      }));
+      contentArr.push({ type: 'text', text: m.content });
+      return { role: m.role === 'assistant' ? 'assistant' : 'user', content: contentArr };
+    }
+    return {
+      role: m.role === 'assistant' ? 'assistant' : 'user',
+      content: m.content,
+    };
+  });
 
   for (let step = 0; step < agentCfg.maxSteps; step++) {
     if (signal?.aborted) { await onChunk({ type: 'error', error: 'Cancelled.' }); return; }
@@ -396,10 +414,22 @@ async function runOpenAIAgent(
     function: { name: t.name, description: t.description, parameters: t.parameters },
   }));
 
-  type OAIMsg = { role: string; content: string | null; tool_calls?: unknown[]; tool_call_id?: string };
+  type OAIMsg = { role: string; content: string | unknown[] | null; tool_calls?: unknown[]; tool_call_id?: string };
   const history: OAIMsg[] = [];
   if (systemPrompt) history.push({ role: 'system', content: systemPrompt });
-  for (const m of messages) history.push({ role: m.role, content: m.content });
+  for (const m of messages) {
+    if (m.images && m.images.length > 0) {
+      // Build content array with image_url blocks + text
+      const contentArr: unknown[] = m.images.map((img) => ({
+        type: 'image_url',
+        image_url: { url: `data:${img.mimeType};base64,${img.base64}` },
+      }));
+      contentArr.push({ type: 'text', text: m.content });
+      history.push({ role: m.role, content: contentArr });
+    } else {
+      history.push({ role: m.role, content: m.content });
+    }
+  }
 
   for (let step = 0; step < agentCfg.maxSteps; step++) {
     if (signal?.aborted) { await onChunk({ type: 'error', error: 'Cancelled.' }); return; }