> ## Documentation Index
> Fetch the complete documentation index at: https://0xcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> The tools Akio provides to the LLM out of the box.

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:**

```text theme={null}
> 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.

> [!WARNING]
>
> 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:**

```text theme={null}
> 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:**

```text theme={null}
> 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:**

```text theme={null}
> Find all Rust source files in the src directory
```

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:**

```text theme={null}
> Summarise this article for me
https://hackaday.com/2019/09/11/lambdas-for-c-sort-of/
```

The agent sends a GET request to the URL, parses the JSON response, and reports the `stargazers_count` field back to you.

***

## Web Search

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:**

```text theme={null}
> 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)](https://0xcat.mintlify.site/mcp-client.md) servers, letting you plug in any external capability — browser automation, database access, custom APIs, and more.

> [card] [MCP Servers](https://0xcat.mintlify.site/mcp-client.md)
>
> Learn how to add and manage MCP servers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.