Beledarian's LM Studio Tools

This project is a plugin for LM Studio that provides a rich set of tools to a large language model. It acts as a bridge between the LLM and your local environment, enabling autonomous coding, research, and file management.

Key Features

File System Mastery

• Full Control: Create, read, update, delete, move, and copy files.
• Safe & Secure: All operations are sandboxed to your workspace directory to prevent path traversal attacks.
• Smart Updates: Use replace_text_in_file to make surgical edits instead of rewriting large files.
• Batch Processing: save_file supports creating multiple files in one go.
• Cleanup: Use delete_files_by_pattern to wipe temporary files instantly.

Recent Updates

• Smart Context Injection: subagent_docs.md is automatically loaded into the context, ensuring the Main Agent understands how to delegate effectively.

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:

• Install dependencies:

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).

Available Tools

File System

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.