ai-toolbox
Public
Forked from crunch3r/ai-toolbox
Forked from crunch3r/ai-toolbox
108 tools across 17 core categories identified in current source code. (22 Git/GitHub tools + 86 others)
| 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 |
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 · read_document · analyze_project
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_auth · 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
run_background_command · check_background_command · cancel_background_command
run_javascript · run_python · execute_command · run_in_terminal · run_tests
save_memory · get_system_info · read_clipboard · write_clipboard · send_notification · findLMStudioHome · get_enabled_tools · system_monitor · process_list · env_inspect · hash_file · token_count · convert_format · secret_scan · port_check · package_manage · detect_os_environment · json_query · env_update · get_current_working_directory · markdown_table_gen · refactor_code
image_to_text · compare_images · describe_image · screenshot_desktop
vector_rag_search (and related semantic retrieval functions)
ui_generate_component · ui_render_html · ui_preview_element
auto_summarize_context · get_context_memory · search_context · context_summary · delete_context_entry · clear_context_memory · add_context_entry
text_transform · line_operations · text_extract · markdown_table_gen
create_backup · list_backups · delete_backup · line_operations
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, , etc.). The plugin will detect authentication status automatically.⚠️ GitHub Tools Require CLI: Local Git operations (status, commit, diff) work without
gh. Remote API operations (create issues, list PRs, push to origin) requireghinstalled and authenticated on your system.
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.
Comprehensive overhaul targeting disk I/O reduction, cache utilization, and event-loop contention.
refactor_code Full AST-Based extract_function Implementation| 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.
| 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) |
gh_list_prs_queueSave() with 500ms coalescing → ~90% fewer writes during bulk ops)getAllKeys() O(1) cache hit vs. O(n) disk reads, 1s TTL + auto-invalidate on mutation)AI_TOOLBOX_DEBUG env var (~80% less stderr I/O in production)JSON.stringify() memoization via sizeValueCache)getProjectMemoryFilePath(), eliminates duplicate fs.stat())# 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