diff --git a/assets/agents/coder/README.md b/assets/agents/coder/README.md index 747865f..dd23a02 100644 --- a/assets/agents/coder/README.md +++ b/assets/agents/coder/README.md @@ -2,7 +2,7 @@ An AI agent that assists you with your coding tasks. -This agent is designed to be delegated to by the **[Sisyphus](../sisyphus/README.md)** agent to implement code specifications. Sisyphus +This agent is designed to be delegated to by the **[Sisyphus](../sisyphus/README.md)** agent to implement code specifications. Sisyphus acts as the coordinator/architect, while Coder handles the implementation details. ## Features @@ -13,4 +13,28 @@ acts as the coordinator/architect, while Coder handles the implementation detail - 🧐 Advanced code analysis and improvement suggestions - 📊 Precise diff-based file editing for controlled code modifications -It can also be used as a standalone tool for direct coding assistance. \ No newline at end of file +It can also be used as a standalone tool for direct coding assistance. + +## Pro-Tip: Use an IDE MCP Server for Improved Performance +Many modern IDEs now include MCP servers that let LLMs perform operations within the IDE itself and use IDE tools. Using +an IDE's MCP server dramatically improves the performance of coding agents. So if you have an IDE, try adding that MCP +server to your config (see the [MCP Server docs](../../../docs/function-calling/MCP-SERVERS.md) to see how to configure +them), and modify the agent definition to look like this: + +```yaml +# ... + +mcp_servers: + - jetbrains # The name of your configured IDE MCP server + +global_tools: + # Keep useful read-only tools for reading files in other non-project directories + - fs_read.sh + - fs_grep.sh + - fs_glob.sh +# - fs_write.sh +# - fs_patch.sh + - execute_command.sh + +# ... +``` \ No newline at end of file diff --git a/assets/agents/explore/README.md b/assets/agents/explore/README.md index 9085c77..54874ba 100644 --- a/assets/agents/explore/README.md +++ b/assets/agents/explore/README.md @@ -2,7 +2,7 @@ An AI agent specialized in exploring codebases, finding patterns, and understanding project structures. -This agent is designed to be delegated to by the **[Sisyphus](../sisyphus/README.md)** agent to gather information and context. Sisyphus +This agent is designed to be delegated to by the **[Sisyphus](../sisyphus/README.md)** agent to gather information and context. Sisyphus acts as the coordinator/architect, while Explore handles the research and discovery phase. It can also be used as a standalone tool for understanding codebases and finding specific information. @@ -13,3 +13,25 @@ It can also be used as a standalone tool for understanding codebases and finding - 📂 File system navigation and content analysis - 🧠 Context gathering for complex tasks - 🛡️ Read-only operations for safe investigation + +## Pro-Tip: Use an IDE MCP Server for Improved Performance +Many modern IDEs now include MCP servers that let LLMs perform operations within the IDE itself and use IDE tools. Using +an IDE's MCP server dramatically improves the performance of coding agents. So if you have an IDE, try adding that MCP +server to your config (see the [MCP Server docs](../../../docs/function-calling/MCP-SERVERS.md) to see how to configure +them), and modify the agent definition to look like this: + +```yaml +# ... + +mcp_servers: + - jetbrains # The name of your configured IDE MCP server + +global_tools: + - fs_read.sh + - fs_grep.sh + - fs_glob.sh + - fs_ls.sh + - web_search_loki.sh + +# ... +``` diff --git a/assets/agents/oracle/README.md b/assets/agents/oracle/README.md index f380587..8497524 100644 --- a/assets/agents/oracle/README.md +++ b/assets/agents/oracle/README.md @@ -2,7 +2,7 @@ An AI agent specialized in high-level architecture, complex debugging, and design decisions. -This agent is designed to be delegated to by the **[Sisyphus](../sisyphus/README.md)** agent when deep reasoning, architectural advice, +This agent is designed to be delegated to by the **[Sisyphus](../sisyphus/README.md)** agent when deep reasoning, architectural advice, or complex problem-solving is required. Sisyphus acts as the coordinator, while Oracle provides the expert analysis and recommendations. @@ -15,3 +15,25 @@ It can also be used as a standalone tool for design reviews and solving difficul - ⚖️ Tradeoff analysis and technology selection - 📝 Code review and best practices advice - 🧠 Deep reasoning for ambiguous problems + +## Pro-Tip: Use an IDE MCP Server for Improved Performance +Many modern IDEs now include MCP servers that let LLMs perform operations within the IDE itself and use IDE tools. Using +an IDE's MCP server dramatically improves the performance of coding agents. So if you have an IDE, try adding that MCP +server to your config (see the [MCP Server docs](../../../docs/function-calling/MCP-SERVERS.md) to see how to configure +them), and modify the agent definition to look like this: + +```yaml +# ... + +mcp_servers: + - jetbrains # The name of your configured IDE MCP server + +global_tools: + - fs_read.sh + - fs_grep.sh + - fs_glob.sh + - fs_ls.sh + - web_search_loki.sh + +# ... +``` diff --git a/assets/agents/sisyphus/README.md b/assets/agents/sisyphus/README.md index efb4668..c167d41 100644 --- a/assets/agents/sisyphus/README.md +++ b/assets/agents/sisyphus/README.md @@ -1,6 +1,6 @@ # Sisyphus -The main coordinator agent for the Loki coding ecosystem, providing a powerful CLI interface for code generation and +The main coordinator agent for the Loki coding ecosystem, providing a powerful CLI interface for code generation and project management similar to OpenCode, ClaudeCode, Codex, or Gemini CLI. _Inspired by the Sisyphus and Oracle agents of OpenCode._ @@ -16,3 +16,26 @@ Sisyphus acts as the primary entry point, capable of handling complex tasks by c - 💻 **CLI Coding**: Provides a natural language interface for writing and editing code. - 🔄 **Task Management**: Tracks progress and context across complex operations. - 🛠️ **Tool Integration**: Seamlessly uses system tools for building, testing, and file manipulation. + +## Pro-Tip: Use an IDE MCP Server for Improved Performance +Many modern IDEs now include MCP servers that let LLMs perform operations within the IDE itself and use IDE tools. Using +an IDE's MCP server dramatically improves the performance of coding agents. So if you have an IDE, try adding that MCP +server to your config (see the [MCP Server docs](../../../docs/function-calling/MCP-SERVERS.md) to see how to configure +them), and modify the agent definition to look like this: + +```yaml +# ... + +mcp_servers: + - jetbrains + +global_tools: + - fs_read.sh + - fs_grep.sh + - fs_glob.sh + - fs_ls.sh + - web_search_loki.sh + # - execute_command.sh + +# ... +```