Recent Updates

• Smart Context Injection: subagent_docs.md is automatically loaded into the context, ensuring the Main Agent understands how to delegate effectively.
• Enhanced Reporting: Fixed file path reporting in consult_secondary_agent and clarified "Hidden Code" success messages.
• Project Tracking: Sub-agents now enforce the creation and maintenance of beledarian_info.md to track project state.
• Strict Naming: Improved instructions to ensure sub-agents use correct file extensions (e.g., .json vs .js).

Autonomous Agents

• Secondary Agent: Delegate complex tasks (coding, summarization) to a second local model/server.
• Auto-Save: When the sub-agent generates code, the system automatically detects and saves it to your disk. No more copy-pasting!
• Auto-Debug: (Optional) Triggers a "Reviewer" agent to analyze generated code and fix bugs automatically before returning the result.
• Project Context: Agents can read beledarian_info.md to understand your project's history.

Code Execution

• Sandboxed: Run JavaScript (Deno) and Python code.
• Terminal: Execute shell commands or open real terminal windows for interactive tasks.

[!WARNING] Enabling shell or terminal execution allows the model to run arbitrary commands on your system. If enabled, the model may be able to modify files and escape the sandbox environment.

Web & RAG

• Research: Search DuckDuckGo, Wikipedia, or fetch raw web content.
• Web RAG: Chat with website content.
• Local RAG: Semantic search over your workspace files (rag_local_files).

Requirements

• Node.js (v18+)
• LM Studio (v0.3.0+)

💡 Tip: Need persistent long-term memory for your agent? Check out my other project: Local Memory MCP – A privacy-first memory server with knowledge graph support.

Installation

The plugin can be installed using the following link:

https://lmstudio.ai/beledarian/beledarians-lm-studio-tools

Alternatively, you can install it manually for development purposes.

Development

If you want to contribute to the development of this plugin, you can follow these steps:

• Clone the repository:

  git clone https://github.com/Beledarian/Beledarians_LM_Studio_Toolbox.git
  cd Beledarians_LM_Studio_Toolbox
  

• Install dependencies:

• Run in development mode: From within the project directory, run the following command:

  This will start the plugin in development mode. LM Studio should automatically pick it up. Any changes you make to the source code will cause the plugin to automatically reload.

Configuration

Access these settings in the LM Studio "Plugins" tab:

• Enable Secondary Agent: Unlock the power of sub-agents.
• Sub-Agent Profiles: Custom prompts for "Coder", "Reviewer", etc.
• Auto-Debug Mode: Automatically review sub-agent code.
• Sub-Agent Auto-Save: Toggle automatic file saving (Default: On).
• Show Full Code Output: Toggle whether to display the full code in chat or hide it for brevity (files are still saved).
• Safety: Enable/Disable "Allow Code Execution" for Python/JS/Shell.

Available Tools

File System

• list_directory, change_directory, make_directory
• read_file, save_file (supports batch), delete_path
• replace_text_in_file: Precision editing.
• delete_files_by_pattern: Regex-based cleanup.
• move_file, copy_file, find_files, get_file_metadata

Agent

• consult_secondary_agent: The powerhouse tool. Delegates tasks, handles file creation, and manages sub-agent loops.

Web

• duckduckgo_search, wikipedia_search
• fetch_web_content, rag_web_content
• browser_open_page (Puppeteer)

Execution

• run_javascript, run_python
• execute_command (Background), run_in_terminal (Interactive)

Utils

• rag_local_files: Search your code.
• save_memory: Long-term memory.
• get_system_info, read_clipboard, write_clipboard

Developer Guide

See CODE_OVERVIEW.md for architectural details.