Skip to main content
When you run akio run, the agent automatically has access to a set of built-in tools. The LLM decides autonomously when and how to use them to complete your request.

​
Shell

Execute arbitrary shell commands on the host system.
  • Runs commands in the current working directory
  • Captures stdout and stderr and feeds the output back to the model
  • Enables tasks like running scripts, installing packages, compiling code, or any system operation
Example usage by the agent:
The agent will call the shell tool with something like lsof -i :8080 or ss -tlnp | grep 8080 and interpret the result.
The shell tool executes commands with the same permissions as the akio process. Review what you ask the agent to do in sensitive environments.

​
Read

Read the contents of a file from the filesystem.
  • Accepts an absolute or relative file path
  • Returns the raw text content to the model
  • Used for code review, log analysis, config inspection, etc.
Example usage by the agent:
The agent reads Cargo.toml and provides an explanation.

​
Write

Write or overwrite a file on the filesystem.
  • Creates the file if it doesn’t exist
  • Overwrites existing content
  • Used for generating code, writing configs, creating documentation, etc.
Example usage by the agent:
The agent writes the script to a .py file.

​
Glob

Search for files matching a glob pattern.
  • Supports standard glob syntax (*, **, ?, {a,b}, etc.)
  • Returns matching file paths
  • Useful for navigating codebases, finding configs, or scoping edits
Example usage by the agent:
The agent uses src/**/*.rs as the glob pattern.

​
Fetch

Fetch the contents of a URL via an HTTP GET request.
  • Sends a GET request to the specified URL
  • Returns the response body to the model, along with basic metadata like status code and content type
  • Used for retrieving documentation pages, API endpoints, raw files, or any other resource by direct link. No search step required
Example usage by the agent:
The agent sends a GET request to the URL, parses the JSON response, and reports the stargazers_count field back to you.
Search the web for up-to-date information.
  • Submits a search query and returns ranked results
  • Allows the agent to look up documentation, error messages, news, etc.
  • Works fully offline for everything else — only this tool requires internet
Example usage by the agent:
The agent queries the web and reports back the current version from crates.io or docs.

​
Extending with MCP

Need tools beyond the defaults? Akio supports Model Context Protocol (MCP) servers, letting you plug in any external capability — browser automation, database access, custom APIs, and more.

MCP Servers

Learn how to add and manage MCP servers.