Tools

Terminal Agent provides various tools to help you interact with your system and external services.

Built-in Tools

unix

The unix tool allows you to execute Unix/bash commands:

agent tool exec unix "ls -la"

Input schema:

{
  "command": "The Unix command to execute (string)"
}

This tool provides access to common Unix commands like ls, grep, find, cat, etc. For security reasons, not all Unix commands are available.

websearch

The websearch tool allows you to search the web:

agent tool exec websearch "golang concurrency patterns"

Input schema:

{
  "query": "The search query (string)"
}

This tool returns search results with links and snippets.

Using Tools Directly

You can directly execute tools using the tool exec command:

agent tool exec <tool-name> <input>

Examples:

# List files in current directory
agent tool exec unix "ls -la"

# Search for information
agent tool exec websearch "how to create a git repository"

Using Tools in Tasks

Tools are also used automatically by the task command. When you provide a task description, the agent will:

Analyze the task
Determine which tools are needed
Execute the appropriate tools to complete the task

Example:

agent task "Show me the largest files in the current directory"

The agent might use the unix tool with commands like du -sh * | sort -hr to complete this task.

Model Context Protocol (MCP) Tools

Terminal Agent supports extending its capabilities through Model Context Protocol (MCP) tools:

Create an MCP JSON file defining your tools

Configure Terminal Agent to use your MCP file:

agent config set mcp-path /path/to/mcp.json

Your custom tools will now be available:
```
agent tool list
```

MCP File Example

{
  "name": "custom-tools",
  "version": "0.1",
  "tools": [
    {
      "name": "weather",
      "description": "Get weather information for a location",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "The location to get weather for"
          },
          "units": {
            "type": "string",
            "enum": ["celsius", "fahrenheit"],
            "description": "Temperature units"
          }
        },
        "required": ["location"]
      }
    }
  ]
}

Security Considerations

The unix tool executes commands on your system, so use caution:

Review commands before execution
Terminal Agent will ask for confirmation before running commands
Some potentially harmful commands are not allowed
Use the tool in trusted environments only