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

# Tools and Plugins

# Tools and Plugins

Everything the agent does beyond generating text happens through **tools**.
Tools are how the agent reads files, runs commands, browses the web, sends
messages, and interacts with devices.

## Tools, skills, and plugins

Agdi has three layers that work together:

**1. Tools are what the agent calls**

A tool is a typed function the agent can invoke (e.g. `exec`, `browser`,
`web_search`, `message`). Agdi ships a set of **built-in tools** and
plugins can register additional ones.

The agent sees tools as structured function definitions sent to the model API.

**2. Skills teach the agent when and how**

A skill is a markdown file (`SKILL.md`) injected into the system prompt.
Skills give the agent context, constraints, and step-by-step guidance for
using tools effectively. Skills live in your workspace, in shared folders,
or ship inside plugins.

[Skills reference](https://agdiai-597e782f.mintlify.site/tools/skills.md) | [Creating skills](https://agdiai-597e782f.mintlify.site/tools/creating-skills.md)

**3. Plugins package everything together**

A plugin is a package that can register any combination of capabilities:
channels, model providers, tools, skills, speech, image generation, and more.
Some plugins are **core** (shipped with Agdi), others are **external**
(published on npm by the community).

[Install and configure plugins](https://agdiai-597e782f.mintlify.site/tools/plugin.md) | [Build your own](https://agdiai-597e782f.mintlify.site/plugins/building-plugins.md)

## Built-in tools

These tools ship with Agdi and are available without installing any plugins:

| Tool | What it does | Page |
| - | - | - |
| `exec` / `process` | Run shell commands, manage background processes | [Exec](https://agdiai-597e782f.mintlify.site/tools/exec.md) |
| `browser` | Control a Chromium browser (navigate, click, screenshot) | [Browser](https://agdiai-597e782f.mintlify.site/tools/browser.md) |
| `web_search` / `web_fetch` | Search the web, fetch page content | [Web](https://agdiai-597e782f.mintlify.site/tools/web.md) |
| `read` / `write` / `edit` | File I/O in the workspace | |
| `apply_patch` | Multi-hunk file patches | [Apply Patch](https://agdiai-597e782f.mintlify.site/tools/apply-patch.md) |
| `message` | Send messages across all channels | [Agent Send](https://agdiai-597e782f.mintlify.site/tools/agent-send.md) |
| `canvas` | Drive node Canvas (present, eval, snapshot) | |
| `nodes` | Discover and target paired devices | |
| `cron` / `gateway` | Manage scheduled jobs, restart gateway | |
| `image` / `image_generate` | Analyze or generate images | |
| `sessions_*` / `agents_list` | Session management, sub-agents | [Sub-agents](https://agdiai-597e782f.mintlify.site/tools/subagents.md) |

For image work, use `image` for analysis and `image_generate` for generation or editing. If you target `openai/*`, `google/*`, `fal/*`, or another non-default image provider, configure that provider's auth/API key first.

### Plugin-provided tools

Plugins can register additional tools. Some examples:

* [Lobster](https://agdiai-597e782f.mintlify.site/tools/lobster.md) — typed workflow runtime with resumable approvals
* [LLM Task](https://agdiai-597e782f.mintlify.site/tools/llm-task.md) — JSON-only LLM step for structured output
* [Diffs](https://agdiai-597e782f.mintlify.site/tools/diffs.md) — diff viewer and renderer
* [OpenProse](https://agdiai-597e782f.mintlify.site/prose.md) — markdown-first workflow orchestration

## Tool configuration

### Allow and deny lists

Control which tools the agent can call via `tools.allow` / `tools.deny` in
config. Deny always wins over allow.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}
```

### Tool profiles

`tools.profile` sets a base allowlist before `allow`/`deny` is applied.
Per-agent override: `agents.list[].tools.profile`.

| Profile | What it includes |
| - | - |
| `full` | All tools (default) |
| `coding` | File I/O, runtime, sessions, memory, image |
| `messaging` | Messaging, session list/history/send/status |
| `minimal` | `session_status` only |

### Tool groups

Use `group:*` shorthands in allow/deny lists:

| Group | Tools |
| - | - |
| `group:runtime` | exec, bash, process |
| `group:fs` | read, write, edit, apply\_patch |
| `group:sessions` | sessions\_list, sessions\_history, sessions\_send, sessions\_spawn, sessions\_yield, subagents, session\_status |
| `group:memory` | memory\_search, memory\_get |
| `group:web` | web\_search, web\_fetch |
| `group:ui` | browser, canvas |
| `group:automation` | cron, gateway |
| `group:messaging` | message |
| `group:nodes` | nodes |
| `group:agdi` | All built-in Agdi tools (excludes plugin tools) |

### Provider-specific restrictions

Use `tools.byProvider` to restrict tools for specific providers without
changing global defaults:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}
```


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