From ddc8ae085f04b2809f232f98ca5fa3a32aed432c Mon Sep 17 00:00:00 2001 From: Alex Clarke Date: Wed, 3 Jun 2026 14:22:15 -0600 Subject: [PATCH] docs: added documentation for the enabled_tools CSV or list forms --- REPL.md | 2 +- Roles.md | 2 +- Tools.md | 12 +++++++++--- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/REPL.md b/REPL.md index 54c22b5..b6ae52d 100644 --- a/REPL.md +++ b/REPL.md @@ -217,7 +217,7 @@ The following settings can be adjusted at runtime: | `continuation_prompt` | string | Custom continuation prompt (supports multi-word values; `null` to reset) | | `temperature` | float | Model temperature parameter | | `top_p` | float | Model top-p parameter | -| `enabled_tools` | string | Comma-separated list of enabled tools | +| `enabled_tools` | string | Comma-separated list of enabled tools (e.g. `fs_ls,fs_cat` or `all`); the saved YAML config also accepts a list form | | `enabled_mcp_servers` | string | Comma-separated list of enabled MCP servers (e.g. `github,slack` or `all`); the saved YAML config also accepts a list form | | `enabled_skills` | string | Comma-separated list of enabled [skills](Skills) (e.g. `git-master,ai-slop-remover`); `null` clears the override | | `save_session` | boolean | Whether to auto-save sessions | diff --git a/Roles.md b/Roles.md index ea9efa5..eafc824 100644 --- a/Roles.md +++ b/Roles.md @@ -56,7 +56,7 @@ The following table lists the available configuration settings and their default | `model` | Default configured model or currently in-use model (REPL mode) | The preferred model to use with this role | | `temperature` | Default `temperature` for the preferred model | Controls the creativity and randomness of the model's responses | | `top_p` | Default `top_p` for the preferred model | Alternative way to control the model's output diversity, affecting the
probability distribution of tokens | -| `enabled_tools` | Global setting for `enabled_tools` | The tools that this role utilizes | +| `enabled_tools` | Global setting for `enabled_tools` | The tools that this role utilizes. Accepts either a YAML list or a comma-separated string | | `enabled_mcp_servers` | Global setting for `enabled_mcp_servers` | The MCP servers that this role utilizes. Accepts either a YAML list or a comma-separated string | | `skills_enabled` | Global setting for `skills_enabled` | Master switch for [skills](Skills) under this role. Set to `false` to hide all skills | | `enabled_skills` | Global setting for `enabled_skills` | The [skills](Skills) this role activates. Accepts either a YAML list or a comma-separated string | diff --git a/Tools.md b/Tools.md index 99aa395..58079db 100644 --- a/Tools.md +++ b/Tools.md @@ -74,7 +74,12 @@ The following settings are available in the global configuration for tools: function_calling_support: true # Enables or disables function calling in any context mapping_tools: # Alias for a tool or toolset fs: 'fs_cat,fs_ls,fs_mkdir,fs_rm,fs_write' -enabled_tools: null # Which tools to use by default. (e.g. 'fs,web_search_coyote') +enabled_tools: null # Which tools to use by default. + # Accepts either a YAML list or a comma-separated string. Examples: + # enabled_tools: fs,web_search_coyote + # enabled_tools: + # - fs + # - web_search_coyote visible_tools: # Which tools are visible to be compiled (and are thus able to be defined in 'enabled_tools') # - demo_py.py - execute_command.sh @@ -113,7 +118,8 @@ context. When you create a role, you have the following global tool-related configuration options available to you: ```yaml -enabled_tools: query_jira_issues # Which tools the role uses. +enabled_tools: # Which tools the role uses. Accepts a YAML list (as shown) + - web_search_coyote # or a comma-separated string (e.g. `enabled_tools: web_search_coyote`). ``` The values for `mapping_tools` are inherited from the [global configuration](#global-configuration). @@ -125,7 +131,7 @@ When you create an agent, you have the following global tool-related configurati ```yaml global_tools: # Which global tools the agent uses - - query_jira_issues.sh + - web_search_coyote.sh - fs_cat.sh - fs_ls.sh ```