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: 
> List all running processes and find anything using port 8080
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: 
> Explain what the Cargo.toml in this project does
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: 
> Create a Python script that fetches the top 10 posts from Hacker News
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: 
> Find all Rust source files in the src directory
The agent uses src/**/*.rs as the glob pattern.
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: 
> What's the latest stable version of the tokio crate?
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.