# `Condukt.Tools`
[🔗](https://github.com/tuist/condukt/blob/1.5.1/lib/condukt/tools.ex#L1)

Built-in tools for Condukt.

## Default Tool Sets

- `coding_tools/0` - Read, Bash, Edit, Write, Glob, Grep (default for coding agents)
- `read_only_tools/0` - Read, Bash, Glob, Grep (read-only access)

## Individual Tools

- `Condukt.Tools.Read` - Read file contents
- `Condukt.Tools.Bash` - Execute bash commands
- `Condukt.Tools.Command` - Execute one trusted command without shell parsing
- `Condukt.Tools.Edit` - Surgical file edits
- `Condukt.Tools.Write` - Write files
- `Condukt.Tools.Glob` - Find files by glob pattern
- `Condukt.Tools.Grep` - Search file contents by regex
- `Condukt.Tools.Subagent` - Delegate work to registered sub-agent roles

Every built-in tool routes its filesystem and process work through the
active `Condukt.Sandbox`, so the same tool list works against the host
filesystem (`Sandbox.Local`) or an isolated virtual filesystem
(`Sandbox.Virtual`). Command tools also receive session secrets as
environment variables when configured at `start_link/1`.

## Usage

    defmodule MyAgent do
      use Condukt

      @impl true
      def tools do
        Condukt.Tools.coding_tools()
      end
    end

Or pick specific tools:

    def tools do
      [
        Condukt.Tools.Read,
        Condukt.Tools.Bash
      ]
    end

# `all`

Returns all built-in tools that can be attached directly to an agent.

`Condukt.Tools.Subagent` is injected automatically when an agent declares
sub-agents, so it is not included here.

# `coding_tools`

Returns the default coding tools: Read, Bash, Edit, Write, Glob, Grep.

These tools provide full filesystem access for coding agents through the
active sandbox.

# `read_only_tools`

Returns read-only tools: Read, Bash, Glob, Grep.

Use these when you want the agent to explore but not modify files.
Note that Bash can still execute arbitrary commands. Prefer a parameterized
`Condukt.Tools.Command` when you want to grant a specific executable such as
`git`, `gh`, or `mix`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*