Project Files
README
116 tools / Total: 116 (context-aware replacement handled below per file) across 15 core categories, fully integrated and ready for use.
116 tools across ~20 core categories, fully integrated and ready for use.
All tools dynamically registered with category-level gating. All tools registered via direct SDK pattern (no gateway indirection).
| Feature | Description |
|---|---|
| 📁 File System | Read, write, search, and manage files with path validation & backup support |
| 🌐 Web Research | Multi-engine search (DDG, Google, Bing) with automatic fallback |
| 🖥️ Browser Automation | Headless Puppeteer browser with persistent sessions & UI interaction |
| 🐙 Git & GitHub | Full Git operations (including stash/blame) + GitHub API integration |
| 🗃️ Database | Read-only SQLite queries with SQL validation |
| ⏳ Background Commands | Long-running process management and status tracking |
| ⚡ Code Execution | Sandboxed JS/Python + full shell commands (pipes, redirects, env vars) |
| 🔧 Utilities | Clipboard, notifications, system info, memory, session summaries, and environment management |
| 🖼️ Image Processing | OCR (Tesseract.js), screenshots, and image comparison |
| 📊 Vector RAG | Semantic search with vector embeddings for intelligent document retrieval |
| 🎨 UI Generation | Generate and render interactive HTML/CSS/JS components in-browser |
| 🧠 Context Management | Automatic session tracking, decision logging, and memory management |
| 📝 Text Processing | Advanced regex-based text transformations (sed/awk equivalents) |
list_directory · read_file · read_file_chunked · 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 · analyze_project · file_diff · directory_tree · grep_files · find_replace_all
web_search · wikipedia_search · fetch_web_content · rag_web_content
browser_open_page · browser_session_control · browser_session_close · preview_html · open_file
Local Operations (isomorphic-git): git_status · git_diff · git_commit · git_log · git_add · git_checkout · git_stash · git_blame
Remote API (GitHub CLI gh): gh_create_issue · gh_list_issues · gh_view_comments · gh_create_pr · gh_list_prs · gh_push
Note: Remote operations require the GitHub CLI to be installed and authenticated (
gh auth login).
query_database
read_document
run_background_command · check_background_command · cancel_background_command
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 · clear_context_memory · track_important_event · save_session_summary · get_session_summary · save_memory · get_memory · delete_memory
text_transform · text_extract · line_operations · markdown_table_gen
refactor_code · unusedImports
run_javascript · run_python · execute_command · run_in_terminal · run_tests
The plugin is installed as an LM Studio plugin. Ensure you have:
gh) — required for remote GitHub operations (Issues, PRs). Install at https://cli.github.com/gh auth login in your terminal once to enable remote operations (gh_create_issue, gh_list_prs, etc.). The plugin will detect authentication status automatically.The plugin uses a comprehensive configuration schema (src/config.ts) which is exposed in LM Studio's settings UI. Key features include:
Comprehensive documentation of security features, threat models, and responsible disclosure of 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.
# Install dependencies npm install # Build the project (ESM + CJS via Tsup) npm run build # Run type checking npm run typecheck # Run test suite npm test
Eliminated all any type usage and fixed config resolution for ParsedConfig wrapper.
z.any() with z.unknown() in Zod schemaslatest.timestamp! with latest.timestamp ?? 0PluginConfig object from .get() calls instead of direct property access on ParsedConfig wrapperas unknown as double-cast for @typescript-eslint/parser return typeRegistered 8 new utility tools and removed orphaned gateway pattern code.
backupTools (create_backup, list_backups, restore_backup, delete_backup)cleanupBackupsTool (cleanup_backups)dataVisualizationTools (generate_chart)lineOperations (delete_lines)markdownPreviewTools (markdown_preview)utility config toggle to enable/disable all utility toolsgatewayTools.ts, devOpsTools.ts, gitHubTools.ts (dead code)markdown-it dependency for markdown preview toolIntroduced the Gateway Pattern to prevent LLM tool-bloat crashes and provide controlled access to all registered tools.
explore_tools — Discovers available tool categories without exposing all tools at once (prevents grammar parser crashes)execute_gateway_tool — Delegates execution to any registered tool by name with built-in validationgatewayTools.ts) exist but are NOT yet imported/registered in toolsProvider.ts. Full integration pending.Resolved critical grammar parser failure in production — tool count capping now enforced at 25 tools (was 50), minifier properly wired up.
Resolved critical grammar parser failure and added defensive error handling for SDK token counting.
| Package | Version | Purpose |
|---|---|---|
@lmstudio/sdk | ^1.5.0 | Core SDK for LM Studio plugin development |
@dqbd/tiktoken | ^1.0.22 | Accurate token counting for ContextGuard |
puppeteer | ^24.0.0 | Browser automation |
isomorphic-git | ^1.38.6 | Pure JS Git operations (migrated from simple-git in v1.5.25) |
sharp | ^0.33.5 | Image processing |
tesseract.js | ^7.0.0 | OCR engine |
pdf-parse | ^1.1.1 | PDF document parsing |
mammoth | ^1.6.0 | DOCX document parsing |
archiver | ^8.0.0 | ZIP archive creation |
unzipper | ^0.12.3 | ZIP extraction |
zod | ^3.25.0 | Runtime type validation |
MIT License. See LICENSE for details.