🔧 Dynamic Tools

⚙️ Tool Configuration

Configure which tools load at startup via DEVDUCK_TOOLS environment variable.

Format

# Format: package1:tool1,tool2;package2:tool3,tool4
export DEVDUCK_TOOLS="strands_tools:shell,editor;devduck.tools:system_prompt,websocket"

devduck

Default Configuration

# Default tools loaded:
devduck.tools:system_prompt,store_in_kb,websocket,zenoh_peer
strands_tools:retrieve,shell,file_read,file_write,editor,use_agent

🛠️ manage_tools API

Runtime tool management—list, add, remove, or reload tools without restarting.

Examples

# List all tools
manage_tools(action="list")

# Add tools from a package
manage_tools(
    action="add",
    package="strands_fun_tools",
    tool_names="clipboard,screen_reader"
)

# Add tool from file
manage_tools(
    action="add",
    tool_path="./my_custom_tool.py"
)

# Remove tools
manage_tools(
    action="remove",
    tool_names="shell,editor"
)

# Reload specific tools
manage_tools(
    action="reload",
    tool_names="shell"
)

# Reload all (restarts agent)
manage_tools(action="reload")

🐙 Fetch from GitHub

Download and load tools directly from GitHub repositories.

# Fetch tool from GitHub
fetch_github_tool(
    github_url="https://github.com/cagataycali/devduck/blob/main/devduck/tools/websocket.py",
    tool_name="websocket"  # Optional, auto-detected from filename
)

# Tool is immediately available!
websocket(action="status")

Supported URL Formats

# All these work:
https://github.com/owner/repo/blob/main/tools/my_tool.py
https://github.com/owner/repo/tree/main/tools/my_tool.py  
https://raw.githubusercontent.com/owner/repo/main/tools/my_tool.py

📦 Available Tool Packages

📁 Tool Directory

Drop .py files in ./tools/ for instant availability.

# Create ./tools/my_tool.py
from strands import tool

@tool
def my_custom_tool(param: str) -> dict:
    """
    My custom tool description.
    
    Args:
        param: Input parameter
        
    Returns:
        Dict with status and content
    """
    return {
        "status": "success",
        "content": [{"text": f"Processed: {param}"}]
    }

# Save → Tool is immediately available via hot-reload!

Disable Auto-Loading

# Disable loading from ./tools/ directory
export DEVDUCK_LOAD_TOOLS_FROM_DIR=false

✨ Features

📋 DevDuck Tools Reference