> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opengoat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Commands

> Create, run, inspect, and manage provider bindings for agents.

## Primary Run Command

```bash theme={null}
opengoat agent [agent-id] --message <text> [--image <path>] [--session <key|id>] [--new-session|--no-session]
               [--model <model>] [--no-stream] [-- <runtime-args>]
```

Defaults:

* `agent-id` defaults to `config.defaultAgent`, then `OPENGOAT_DEFAULT_AGENT`, then `goat`

## Create and Delete

```bash theme={null}
opengoat agent create <name> [--manager|--individual] [--role <title>] [--reports-to <agent-id|none>] [--skill <skill-id>]
opengoat agent delete <agent-id> [--force]
```

## Inspect Organization Shape

```bash theme={null}
opengoat agent list
opengoat agent info <agent-id>
opengoat agent direct-reportees <agent-id>
opengoat agent all-reportees <agent-id>
opengoat agent last-action [agent-id] [--json]
```

## Update Organization Structure

```bash theme={null}
opengoat agent set-manager <agent-id> <manager-id|none>
opengoat agent set-default <agent-id> [--json]
```

## Provider Binding

```bash theme={null}
opengoat agent provider get <agent-id>
opengoat agent provider set <agent-id> <provider-id>
```

## Explicit Run Variant

```bash theme={null}
opengoat agent run <agent-id> --message <text> [--image <path>] [--session <key|id>] [--new-session|--no-session]
                     [--model <model>] [--no-stream] [-- <runtime-args>]
```