84+ tools across 15 categories: file system, web research, browser automation, Git/GitHub, database, document parsing, background commands, code execution, utilities, image processing, HTTP client, vector RAG, interactive UI generation, auto-context management, backup & restore, and ContextGuard (infinite context management).
Fixed critical UX issue where read_file truncation had no explicit fallback signal:
read_file: Added ⚠️ WARNING in tool description to explicitly instruct LLM to retry with read_file_chunked on truncated outputread_file_chunked: Rewrote description to emphasize "ALWAYS use this" when read_file fails or files exceed 50k charsFixed critical issues with the Vector RAG tool suite:
rag_web_content — New tool to fetch web content and extract relevant chunks via semantic searchrag_query_vector — Now actually searches the vector index instead of returning placeholder dataFixed critical npm dependency vulnerabilities:
npm install with 0 vulnerabilities, 0 warnings ✅Resolved all failing tests with comprehensive fixes:
validatePath() to only check traversal patterns, removing filesystem base validation that failed on fake test pathsFixed 14 TypeScript errors across 7 files:
AutoTrackConfig interface definitionautoTrackingEnabled, autoTrackDecisions, etc.).remote() method with child_process.execSync()---## 📋 Table of Contents
| Feature | Description |
|---|---|
| 📁 File System | Read, write, search, and manage files with path validation |
| 🌐 Web Research | Multi-engine search (DDG, Google, Bing) with automatic fallback |
| 🖥️ Browser Automation | Headless Puppeteer browser with persistent sessions |
| 🐙 Git & GitHub | Full Git operations + GitHub API integration |
| 🗄️ Database | Read-only SQLite queries with SQL validation |
| ⏳ Background Commands | Long-running process management |
| ⚡ Code Execution | Sandboxed JS/Python + full shell commands (pipes, redirects, env vars) |
| 🔧 Utilities | Clipboard, notifications, system info, memory |
| 🖼️ Image Processing |
list_directory · read_file · save_file · replace_text_in_file · insert_at_line · append_file · delete_lines_in_file · make_directory · move_file · copy_file · delete_path · delete_files_by_pattern · find_files · fuzzy_find_local_files · get_file_metadata · change_directory
web_search · wikipedia_search · fetch_web_content · rag_web_content
browser_open_page · browser_session_control · browser_session_close · preview_html · open_file
git_status · git_diff · git_commit · git_log · git_add · git_checkout · gh_auth · gh_create_issue · gh_list_issues · gh_view_comments · gh_create_pr · gh_list_prs · gh_view_pr_diff · gh_push
query_database
read_document
run_background_command · check_background_command · cancel_background_command
run_javascript · run_python · execute_command · run_in_terminal
save_memory · get_system_info · read_clipboard · write_clipboard · send_notification · findLMStudioHome · get_enabled_tools
image_to_text · describe_image · screenshot_desktop · compare_images
http_request · http_get_json · http_post_json
rag_index_files · rag_query_vector · rag_clear_index · rag_web_content
generate_ui_component · render_and_preview_ui · extract_ui_data
auto_summarize_context · get_context_memory · search_context · context_summary · delete_context_entry · track_important_event · clear_context_memory
create_backup · list_backups · restore_backup · delete_backup
The plugin is installed as an LM Studio plugin. Ensure you have:
The LLM can call the web_search tool:
All settings are accessible through LM Studio's plugin settings panel.
| Setting | Default | Description |
|---|---|---|
godMode | false | ⚠️ Enables ALL tools at once |
fileSystem | true | File read/write/search operations |
webSearch | true | Web research tools |
contextGuard | false | New! Enable ContextGuard for infinite context management |
| Setting Name | Type | Default | Description |
|---|---|---|---|
contextGuard | boolean | false | Enable the ContextGuard module. |
tokenLimit | number | 110,000 | The maximum token count before compression triggers. |
smartReading | boolean | true | Enable heuristic keyword-grep for file reads. |
summaryModel | string | gemma-2b | The model used to summarize older history. |
Comprehensive documentation of security features, threat models, and responsible disclosure for the AI Toolbox plugin. See SECURITY.md for details.
Deep dive into the AI Toolbox plugin's system architecture, design patterns, and internal workflows. See ARCHITECTURE.md for details.
| Package | Version | Purpose |
|---|---|---|
@lmstudio/sdk | ^1.5.0 | Core SDK for LM Studio plugin development |
@dqbd/tiktoken | latest | Accurate token counting for ContextGuard |
puppeteer | ^24.0.0 | Browser automation |
simple-git | ^3.22.0 | Git operations |
sharp | ^0.33.5 | Image processing |
tiktoken | latest | Tokenization |
MIT License. See LICENSE for details.
archiverunzippermoduleNameMapper| OCR (Tesseract.js), screenshots (Win32 API), image comparison (JPEG/BMP/PNG via Sharp) |
| 🔌 HTTP Client | REST API client with SSRF protection |
| 📊 Vector RAG | Semantic search with local embeddings, persistent state, web content fetching |
| 📚 Document RAG | Chat with attached files or disk paths (PDF, DOCX, TXT) |
| 🎨 Interactive UI Generation | Generate and render HTML/CSS/JS components (buttons, forms, charts, dashboards) |
| 💾 Backup & Restore | Create compressed ZIP backups of plugin state with path traversal protection |
| 🧠 Auto-Context Management | Automatic session tracking, decision logging, and persistent memory retrieval |
| ⏰ Temporal Awareness | Injects current date/time into every message for accurate time-sensitive tasks |
| 🛡️ ContextGuard | v1.4.1! Dynamic context window management with explicit UI controls: |
| • Smart Reader: Heuristic keyword-grep for large files (toggleable) |
| • Threshold-Based Compression: Auto-summarizes history at 90% token limit (configurable 1K-200K tokens) |
| • Terminal Output Filtering: Truncates long outputs (configurable 100-20K chars) |
• Re-RAG Trigger: reload_context_for_file tool for fresh reads |
| • Token Budget Visualization: Real-time token usage display |
| • Visual Indicator: Rich status display when compression activates (shows tokens saved, percentage, timestamp) |
| • 6 Explicit UI Controls in LM Studio settings panel (no code changes needed!) |
Tool: web_search
Params: { "query": "latest TypeScript features 2025" }
Tool: read_file
Params: { "file_name": "src/index.ts", "max_length": 5000 }
Tool: change_directory
Params: { "directory": "C:\\Projects\\my-app" }
npm install
npm run build